Win11 装 ESP32 Arduino 库卡 3 小时？我把官方 3.3.10 全平台 522MB 搬到了蓝奏云，解压即用

TL;DR

Windows 11 上 Arduino IDE 装 ESP32 库，package_esp32_index.json 从 GitHub 拉取 → 下载 toolchain → 下载 libs，任何一个环节卡住就是报错重来。本文直接把 Espressif 官方 3.3.10 版本的全部 10 个芯片平台 libs 离线包 （esp32 / c3 / c5 / c6 / h2 / p4 / p4_es / s2 / s3 + core）打包好了，522MB，解压即用，无需联网下载。文末提供一键获取方式。

踩坑实录：从"等下载"到"彻底放弃在线安装"

上周在 Win11 上给 Arduino IDE 装 ESP32 3.3.x 开发环境，走了这么一圈：

复制代码

Arduino IDE → 首选项 → 附加开发板管理器网址
→ https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
→ 工具 → 开发板 → 开发板管理器 → 搜索 esp32 → 安装

然后就是无尽的等待。这个 573KB 的 JSON 索引文件指向 223 个 Windows x64 文件，总大小约 20GB------包括：

esptool（烧录工具，v2.3.1 到 v5.3.0）
xtensa / riscv32 交叉编译器（GCC 8.4.0 ~ 14.2.0，每个 100-350MB）
各芯片平台 libs（10 个平台 × 多个版本，每个 40-60MB）
openocd-esp32（调试器，v0.11.0 ~ v0.12.0）
mkspiffs / mklittlefs（文件系统工具）

国内网络环境下，任何一个文件下载失败，Arduino IDE 就静默重试------不报错，不提示，就是一直转圈。你分不清是"正在下载大文件"还是"网络断了在死等 timeout"。

根因：Arduino IDE 的下载机制没做容错

Arduino IDE 的 ESP32 安装流程本质是：

拉取 package_esp32_index.json（573KB，走 raw.githubusercontent.com）
解析 JSON 中的 tools 和 platforms，找到对应平台的下载 URL
逐一下载 .zip / .tar.gz
解压到 %LOCALAPPDATA%/Arduino15/

问题出在第 3 步 ：所有 223 个文件中，你实际只需要你选择的那一个芯片平台 + 对应 toolchain（大约 10-15 个文件），但 Arduino IDE 没有智能选择------它要么全量下载，要么一个失败就整体卡住。

而且这些文件托管在 GitHub Releases （github.com/espressif/...），国内直连速度能到 50KB/s 就算运气好。

解决方案：离线包解压即用

核心思路------绕过 Arduino IDE 的下载器，手动把文件放进 Arduino15 目录。

ESP32 3.3.10 版本文件清单

文件名	大小	用途
`esp32-core-3.3.10.zip`	45MB	核心框架（Arduino API、WiFi/BLE 等）
`esp32-libs-3.3.10.zip`	43MB	ESP32 芯片平台预编译库
`esp32c3-libs-3.3.10.zip`	54MB	ESP32-C3 RISC-V 芯片库
`esp32c5-libs-3.3.10.zip`	63MB	ESP32-C5 新一代 RISC-V 库
`esp32c6-libs-3.3.10.zip`	62MB	ESP32-C6 WiFi 6 芯片库
`esp32h2-libs-3.3.10.zip`	58MB	ESP32-H2 Thread/Zigbee 芯片库
`esp32p4-libs-3.3.10.zip`	60MB	ESP32-P4 高性能芯片库
`esp32p4_es-libs-3.3.10.zip`	60MB	ESP32-P4 ES 版本库
`esp32s2-libs-3.3.10.zip`	41MB	ESP32-S2 USB-OTG 芯片库
`esp32s3-libs-3.3.10.zip`	63MB	ESP32-S3 AI 加速芯片库

将蓝奏云下载的碎片使用下面命令进行合并。

powershell 复制代码

copy /b esp32_3.3.10_part_00.zip + esp32_3.3.10_part_01.zip + esp32_3.3.10_part_02.zip + esp32_3.3.10_part_03.zip + esp32_3.3.10_part_04.zip + esp32_3.3.10_part_05.zip esp32_3.3.10_packages.zip

安装步骤（Windows 11）

powershell 复制代码

# 1. 关闭 Arduino IDE
# 2. 定位到 Arduino15 目录
cd $env:LOCALAPPDATA\Arduino15\packages\esp32

# 3. 解压离线包到 hardware/esp32/<版本号>/
#    具体路径参考 Arduino IDE 中安装 ESP32 后自动创建的目录结构

然后重开 Arduino IDE，工具 → 开发板就能看到 ESP32 系列了。

获取方式

上述 10 个文件的完整离线包（522MB）已上传至：

👉 点击获取：ESP32 Arduino 3.3.10 全平台库（Win x64）

来源：Espressif 官方 package_esp32_index.json 提取，仅筛选 Windows x86_64 平台，未做任何修改。

价格：¥6.90（整理分发费，官方资源免费开源）

小结

Arduino IDE 的在线安装在国内是个隐形地雷------表面只是"加个 URL、点安装"，实质是 200+ 个 GitHub 文件的大规模下载。离线包这件事，官方不做，那我们来补。下次重装系统或换机器，把这个 522MB 的包拿出来，3 分钟搞完，不用再盯着进度条发呆。