【ARDUINO】在arduino ide中下载安装开发包失败了，如何手动安装开发包

- - 一、手动下载ESP32开发包
  - [二、手动安装开发包到Arduino IDE](#二、手动安装开发包到Arduino IDE)
  - 三、验证安装是否成功
  - 四、常见问题解决

如果在Arduino IDE中通过开发板管理器安装"esp32 by Espressif Systems"失败（如网络超时、下载中断等），可以通过手动下载开发包并安装的方式解决，具体步骤如下：

获取开发包下载地址

打开Arduino IDE的「首选项」，找到已添加的ESP32开发包网址（https://dl.espressif.com/dl/package_esp32_index.json），复制该链接在浏览器中打开。

这是一个JSON文件，其中包含了所有ESP32开发包的版本信息和下载链接，找到你需要的版本（建议选最新稳定版，如2.0.14），复制对应的.tar.gz格式下载链接（如https://github.com/espressif/arduino-esp32/releases/download/2.0.14/esp32-2.0.14.tar.gz）。
直接下载开发包

用浏览器或下载工具（如迅雷）打开复制的链接，下载完整的开发包压缩包（.tar.gz格式，大小约100-300MB，根据版本不同）。

若GitHub链接下载慢，可尝试国内镜像（如安信可官网、乐鑫官网的ESP32开发资源页面）。

找到Arduino开发包存放路径
- Windows系统：默认路径为 C:\Users\[你的用户名]\AppData\Local\Arduino15\packages（"AppData"是隐藏文件夹，需开启"显示隐藏文件"）。
- Mac系统：默认路径为 ~/Library/Arduino15/packages（"Library"是隐藏文件夹，可通过"前往文件夹"输入路径访问）。
- Linux系统：默认路径为 ~/.arduino15/packages。
解压并放置开发包
- 在上述packages文件夹中，新建文件夹结构：esp32\hardware\esp32\[版本号]（如esp32\hardware\esp32\2.0.14）。
- 将下载的.tar.gz压缩包解压，把解压后的所有文件（如cores、libraries、platform.txt等）复制到新建的[版本号]文件夹中。
安装工具链（关键步骤）

ESP32开发包需要配套的编译工具链（如xtensa-esp32-elf-gcc），若手动下载的开发包中未包含，需单独下载：
- 回到之前的package_esp32_index.json文件，找到与开发包版本匹配的"tools"部分，下载对应的工具链压缩包（如xtensa-esp32-elf-gcc-8.4.0-esp-2021r2-patch5-win64.zip）。
- 在packages\esp32\tools文件夹中，按工具链名称和版本号新建文件夹（如xtensa-esp32-elf-gcc\8.4.0-esp-2021r2-patch5），将解压后的工具链文件放入其中。

重启Arduino IDE，点击「工具」→「开发板」，若能在列表中找到"ESP32 Arduino"下的具体型号（如"AI-Thinker ESP32-CAM"），则安装成功。
尝试编译一个简单的ESP32-CAM示例代码（如「文件」→「示例」→「ESP32」→「Camera」→「CameraWebServer」），若编译通过，说明开发包和工具链均正常。

通过手动下载安装，可绕过IDE内置的开发板管理器限制，尤其适合网络不稳定的场景，安装逻辑与IDE自动安装一致，只是将"自动下载"改为"手动操作"。