您当前的位置：首页 > 电子 > 电气软件

2025 最新 ESP32-Arduino 3.2.1 离线安装避坑全记录 | 图文教程

时间：07-28来源：作者：点击数：

ESP32-Arduino 3.2.1 完整安装教程（离线 + 在线双方案）

------------------------------------------------

### 0 目录与思路

1. 系统准备

2. 在线安装（网络畅通）

3. 离线安装（网络抽风）

4. 验证 Blink 例程

5. 常见错误对照表

6. 一键 Windows 批处理脚本

------------------------------------------------

1 系统准备

------------------------------------------------

• Windows 10/11（其他系统路径略有不同）

• Arduino IDE ≥ 2.3.2（官网下载 ZIP 版亦可）

• CH340 / CP2102 驱动（设备管理器出现 `COMx` 即成功）

------------------------------------------------

2 在线安装（首选，如果有代理/梯子，3 分钟）

------------------------------------------------

步骤 A 打开 IDE → File → Preferences

在 “Additional boards manager URLs” 填入：

```

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

```

→ OK

步骤 B Tools → Board → Boards Manager → 搜索 `esp32`

→ Install “ESP32 by Espressif Systems” （等待自动下载 7 个包，约 2–3 GB）

步骤 C Tools → Board → ESP32 → “ESP32 Dev Module”

Tools → Port → 选择对应 COMx

------------------------------------------------

3 离线安装（10 分钟）

------------------------------------------------

原因：GitHub 被墙/限速，IDE 报 `wsarecv` 或 `Not Found`。

3.1 一次下载 7 个必需 ZIP

（大小为近似值，仅供核对）

| 序号 | 文件名（必须一字不差） | 大小 | 下载链接  |
|------|----------------------------|------|------------|
|   1   | `esp32-3.2.1.zip`  | 25 MB | `https://github.com/espressif/arduino-esp32/releases/download/3.2.1/esp32-3.2.1.zip` |
|   2   | `esp32-arduino-libs-idf-release_v5.4-858a988d-v1.zip` | 1 GB | 同上仓库 |
|   3   | `xtensa-esp-elf-gdb-14.2_20240403-x86_64-w64-mingw32.zip` | 35 MB | 同上仓库 |
|   4   | `riscv32-esp-elf-gdb-14.2_20240403-x86_64-w64-mingw32.zip` | 33 MB | 同上仓库 |
|   5   | `openocd-esp32-v0.12.0-esp32-20250422-x86_64-w64-mingw32.zip` | 3 MB | 同上仓库 |
|   6   | `esptool_py-5.0.dev1-windows.zip` | 2 MB | 同上仓库 |
|   7   | `dfu-util-0.11.0-arduino5-windows.zip` | 0.3 MB | 同上仓库 |

*镜像前缀失效时，自行搜索 GitHub 加速站。

注：

遇到这种无法网址打开的情况大概率是因为镜像前缀失效

3.2 放置路径（Windows）

```

Win + R → 输入

%LOCALAPPDATA%\Arduino15\staging\packages

```

把 7 个 zip **原样放进去**（不要解压）。

重启 IDE → Boards Manager → 再次点击 Install 3.2.1 → 秒过。

macOS / Linux 路径

```

~/Library/Arduino15/staging/packages/ # macOS

~/.arduino15/staging/packages/ # Linux

```

------------------------------------------------

4 验证 Blink 例程（1 分钟）

------------------------------------------------

1. File → Examples → 01.Basics → Blink

2. 点击 Upload（→）

3. 观察板载 LED 1 Hz 闪烁 → 成功！

串口监视器输出示意：

```
ets Jun  8 2016 00:22:57
rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
...
Hello from ESP32!
```

------------------------------------------------

5 常见错误对照表

------------------------------------------------

| 屏幕提示 | 可能原因 | 解决 |

|---|---|---|

| `esp32-3.2.1.zip Not Found` | 官方改名/删除 | 用本文 3.1 真实链接 |

| `TLS handshake timeout` | 被墙 | 换镜像或开代理 |

| `Connecting...____` | 未进下载模式 | 按住 BOOT 再按 EN |

| `Failed to connect` | 驱动/线材 | 换数据线或重装驱动 |

------------------------------------------------

6 一键 Windows 批处理脚本

------------------------------------------------

把下面保存为 `esp32_offline.bat`，双击即可打开 staging 目录，提示你放 ZIP。

```bat
@echo off
set target=%LOCALAPPDATA%\Arduino15\staging\packages
if not exist "%target%" mkdir "%target%"
explorer "%target%"
echo.
echo 把 7 个 zip 拖进来后，重启 Arduino IDE 安装 ESP32 3.2.1
pause
```