285.3.开发环境配置

本节只演示 Arduino IDE、库和开发板支持包的安装与选择，没有编写或讲解项目业务源码，因此不添加源码代码块。

一、开发环境配置

本节的目标是在 Windows 上让 Arduino IDE 认识后续使用的 AI Thinker ESP32-CAM。先分清三种东西：Arduino IDE 是编写、编译和上传程序的软件；Blinker 是项目要用的库；ESP32 开发板支持包包含板型定义、编译工具等，使 IDE 能编译 ESP32 程序。安装了库，不等于安装了开发板支持包；在“其他开发板管理器地址”中填写网址，也不等于已经把支持包装好。

1.1 Arduino软件安装配置

1.1.1 Arduino IDE安装

1. 课程资源包附带 Windows 64 位 arduino-ide_2.0.1_Windows_64bit.exe。视频演示按安装程序的默认选项安装，并提醒等待安装完成。默认安装是便于与视频保持一致的做法，不意味着其他安装目录一定会报错。
2. 首次启动 Arduino IDE 时，若出现附加组件的安装提示，按提示完成并等待 IDE 打开；这与下一步导入 Blinker 库是两件事。
3. 若界面默认是英文，可打开“文件（File）→ 首选项（Preferences）”，将编辑器语言改成“中文（简体）”，确认后按提示重启 IDE。原笔记写成“编译器的语言”不准确：这里更改的是 IDE 界面语言，不会改变代码所用的 C/C++ 语法或编译器。

1.1.2 安装库文件的环境

1. 在资源包中找到 Arduino需要的库文件/blinker-library-dev_3.0(1).zip。先解压课程的外层资料包，选择其中这个 Blinker 库 ZIP；不要把整个课程资料 ZIP 当作库导入。
2. 在 IDE 中选择“项目（Sketch）→ 加载库（Include Library）→ 添加 .ZIP 库（Add .ZIP Library…）”，选中上述 ZIP 并打开。等待 IDE 的输出区提示库已安装。该操作把库加入 Arduino 的库目录，不是把 ZIP 放进 Arduino15\packages。
3. 视频随后打开“文件→首选项”，把配套“首选项文件”里的开发板管理器网址粘到“其他开发板管理器地址”。课程文件是多种开发板网址的汇总，既有 ESP8266、STM32 的地址，也有仅在录制者局域网可用的私有 IP 地址；其中个别地址还混入全角冒号。本项目只需要 ESP32，不应机械复制全部网址。开发板管理器地址是供 IDE 在线获取开发板包索引的，不是库文件，也不是开发板包本体。

**两种安装 ESP32 支持包的路径：**为复现视频及其配套源码版本，按下一小节复制课程提供的离线文件；若在全新环境中改用官方在线安装，则在“其他开发板管理器地址”填入 Espressif 当前官方稳定版索引 https://espressif.github.io/arduino-esp32/package_esp32_index.json，再到“工具→开发板→开发板管理器”搜索并安装 esp32。在线安装得到的版本可能不同于课程的 1.0.6，后续示例的菜单和 API 也可能不同。两条路径择一完成即可，不必把课程的旧包覆盖到开发板管理器刚安装的新包上。

1.1.3 开发版文件配置

视频使用的是课程资料内已经准备好的离线开发板包，不是在 Arduino IDE 安装目录中手工找文件。按视频复现时：

1. 先关闭 Arduino IDE。Windows 资源管理器地址栏可直接输入 %LOCALAPPDATA%\Arduino15\packages，它通常对应 C:\Users\<你的用户名>\AppData\Local\Arduino15\packages。AppData 默认可能是隐藏目录；若逐级查找，需要在资源管理器里显示隐藏项目。原笔记的 rdin al 15 → package 是识别错误，应为 Arduino15\packages（末尾有 s）。
2. 从课程资料的 Arduino15添加开发板文件 中，把整个 esp32 文件夹复制进 packages，保持原有层级，例如 packages\esp32\hardware\esp32\1.0.6。配套包还给了 esp8266 文件夹（其开发板核心版本为 2.7.4），视频也一并复制以备其他项目使用；本项目的 ESP32-CAM 不依赖 ESP8266 包。复制可能较慢，等待文件传完。
3. 如果目标位置已有同名 esp32 文件夹，先核对现有版本和内容，避免直接合并、覆盖不同版本的工具文件。复制完成后重新启动 Arduino IDE，让它重新识别开发板。视频重启的是 Arduino 应用程序，不要求重启整台电脑。

开发板支持包在 packages 下，Blinker 库在 Arduino 的库目录下；两者放错位置都可能导致后续编译或选板失败。若使用开发板管理器在线安装，则让 IDE 自行管理 Arduino15\packages，不需要执行上述手工复制步骤。

1.1.4 开发版环境配置

重启 IDE 后，打开“工具→开发板”或 IDE 顶部的开发板选择器，在 esp32 板型列表中选择 AI Thinker ESP32-CAM。课程包 esp32 1.0.6 的 boards.txt 中就列有这个完整板型名称；转录文本里的“ESP32CAN”“AeroticLink”以及原笔记的“alt clink”都是识别错误。若同时复制了 ESP8266 包，列表里也会出现 ESP8266 Boards，但本课程的小车仍选 ESP32-CAM。

选中板型后，IDE 顶部显示 AI Thinker ESP32-CAM，说明当前草图使用这一板型配置。此时只是完成本节的软件环境和板型选择，不能据此证明程序已成功编译、串口已连接或已烧录到主板；串口、接线和上传要在后续实际操作中检查。若菜单里找不到该板型，优先检查 packages\esp32\hardware\esp32\1.0.6 的目录层级、复制是否完整，以及 IDE 是否已重启。

核对依据

• 本地视频 videos/285.3.开发环境配置.mp4 及转录 transcripts/285.3.开发环境配置.txt：安装、导入 ZIP、首选项、复制离线文件、重启 IDE 和选择板型的顺序。
• 课程压缩包 源码/7、项目3、项目4资料/项目3：基于ESP32的物联网WIFI小车.zip：Arduino IDE 2.0.1 安装程序、Blinker 库 ZIP、ESP32 1.0.6 / ESP8266 2.7.4 离线包及“首选项文件”；其中 boards.txt 可核对 AI Thinker ESP32-CAM 板名。
• Espressif 官方 Arduino-ESP32 安装指南：当前开发板索引网址及开发板管理器安装流程。
• Arduino 官方 ZIP 库安装说明、Arduino15 目录说明与库/开发板文件位置说明：核对菜单、Windows 路径及库与板包的存放位置。