ESP32 Arduino核心从3.3.7升级到3.3.8时，遇到“Failed to install platform: 'esp32:esp32:3.3.8'.Error: 13 INTERNAL: Download failed:……”错误，按照下列步骤处理，可成功实现离线升级ESP32 Arduino核心。

一、下载package_esp32_index_cn.json文件

        这是用于国内镜像的索引，可以帮助我们精确获取 3.3.8-cn 的所有工具下载链接。

https://github.com/espressif/arduino-esp32/releases/download/3.3.8/package_esp32_index_cn.json

二、我已整理出手动升级所需下载的文件链接，。

复制下方内容粘贴到迅雷进行多个文件下载。也可以打开以下链接，自己使用迅雷下载。（PS：链接最后的版本号修改后，可以直接跳转到对应的页面）https://github.com/espressif/arduino-esp32/releases/tag/3.3.8。

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32-core-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/crosstool-NG/releases/download/esp-14.2.0_20260121/xtensa-esp-elf-14.2.0_20260121-x86_64-w64-mingw32.zip
https://dl.espressif.cn/github_assets/espressif/crosstool-NG/releases/download/esp-14.2.0_20260121/riscv32-esp-elf-14.2.0_20260121-x86_64-w64-mingw32.zip
https://dl.espressif.cn/github_assets/espressif/binutils-gdb/releases/download/esp-gdb-v16.3_20250913/xtensa-esp-elf-gdb-16.3_20250913-x86_64-w64-mingw32.zip
https://dl.espressif.cn/github_assets/espressif/binutils-gdb/releases/download/esp-gdb-v16.3_20250913/riscv32-esp-elf-gdb-16.3_20250913-x86_64-w64-mingw32.zip
https://dl.espressif.cn/github_assets/espressif/openocd-esp32/releases/download/v0.12.0-esp32-20251215/openocd-esp32-win64-0.12.0-esp32-20251215.zip
https://dl.espressif.cn/github_assets/espressif/esptool/releases/download/v5.2.0/esptool-v5.2.0-windows-amd64.zip
https://dl.espressif.cn/github_assets/earlephilhower/mklittlefs/releases/download/4.0.2/x86_64-w64-mingw32-mklittlefs-db0513a.zip
https://dl.espressif.cn/github_assets/igrr/mkspiffs/releases/download/0.2.3/mkspiffs-0.2.3-arduino-esp32-win32.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c3-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c5-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c6-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32h2-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32p4-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32p4_es-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32s2-libs-3.3.8.zip
https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32s3-libs-3.3.8.zip

如果要有选择下载，可单独复制下方所需文件链接使用迅雷单个下载。
1. 核心平台文件

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32-core-3.3.8.zip

2.Xtensa 工具链

https://dl.espressif.cn/github_assets/espressif/crosstool-NG/releases/download/esp-14.2.0_20260121/xtensa-esp-elf-14.2.0_20260121-x86_64-w64-mingw32.zip

3.RISC‑V 工具链

https://dl.espressif.cn/github_assets/espressif/crosstool-NG/releases/download/esp-14.2.0_20260121/riscv32-esp-elf-14.2.0_20260121-x86_64-w64-mingw32.zip

4.调试器

https://dl.espressif.cn/github_assets/espressif/binutils-gdb/releases/download/esp-gdb-v16.3_20250913/xtensa-esp-elf-gdb-16.3_20250913-x86_64-w64-mingw32.zip

5.RISC‑V 调试器

https://dl.espressif.cn/github_assets/espressif/binutils-gdb/releases/download/esp-gdb-v16.3_20250913/riscv32-esp-elf-gdb-16.3_20250913-x86_64-w64-mingw32.zip

6.调试桥

https://dl.espressif.cn/github_assets/espressif/openocd-esp32/releases/download/v0.12.0-esp32-20251215/openocd-esp32-win64-0.12.0-esp32-20251215.zip

7.烧录工具

https://dl.espressif.cn/github_assets/espressif/esptool/releases/download/v5.2.0/esptool-v5.2.0-windows-amd64.zip

8.mklittlefs

https://dl.espressif.cn/github_assets/earlephilhower/mklittlefs/releases/download/4.0.2/x86_64-w64-mingw32-mklittlefs-db0513a.zip

9.mkspiffs

https://dl.espressif.cn/github_assets/igrr/mkspiffs/releases/download/0.2.3/mkspiffs-0.2.3-arduino-esp32-win32.zip

10.ESP32

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32-libs-3.3.8.zip

11.ESP32‑C3

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c3-libs-3.3.8.zip

12.ESP32‑C5

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c5-libs-3.3.8.zip

13.ESP32‑C6

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32c6-libs-3.3.8.zip

14.ESP32‑H2

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32h2-libs-3.3.8.zip

15.ESP32‑P4

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32p4-libs-3.3.8.zip

16.ESP32‑P4_ES

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32p4_es-libs-3.3.8.zip

17.ESP32‑S2

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32s2-libs-3.3.8.zip

18.ESP32‑S3

https://dl.espressif.cn/github_assets/espressif/arduino-esp32/releases/download/3.3.8/esp32s3-libs-3.3.8.zip

三、打开文件资源管理器，在地址栏输入 %LOCALAPPDATA%\Arduino15\staging\packages 并回车，把以上下载的18个zip文件复制到此文件夹下。不要解压！Arduino IDE 会在安装时自动解压。

四、关闭 Arduino IDE。

删除 %LOCALAPPDATA%\Arduino15\packages\esp32 整个文件夹（如果存在）。

同时删除 %LOCALAPPDATA%\Arduino15\staging\packages 里可能已经存在的老的 .zip 文件（避免 IDE 混淆版本）。

五、离线安装开始
（1）重新打开 Arduino IDE。
（2）出现升级提示，点击“手动”，从左侧开发板管理中找到esp32，确认选择版本3.3.8，点击安装按钮。
（3）如果没有出现升级提示，打开 工具 → 开发板 → 开发板管理器。搜索 esp32，找到 esp32 by Espressif Systems，版本选择 3.3.8（或 3.3.8‑cn），点击 安装。

你会发现很快就安装成功。