从零开始：Arduino + ESP32 安装配置全流程（解决网络问题，附 2.0.9 / 3.2.0 离线包）-CSDN博客

本文链接：https://blog.csdn.net/Zhang_sheng_nan/article/details/147839995

从零开始：Arduino + ESP32 安装配置全流程（解决网络问题，附 2.0.9 / 3.2.0 离线包）

一、安装 Arduino IDE（适用于 Windows）

Arduino 是一个开源电子开发平台，适合初学者和工程师使用。本节将介绍如何在 Windows 系统上下载并安装 Arduino IDE 2.x。

步骤 1：访问 Arduino 官网

打开浏览器，进入官网下载页面：
👉 https://www.arduino.cc/en/software

页面如下所示（建议使用 Chrome 或 Edge 打开）：

📝 提示：如果页面打不开，建议使用科学上网工具，或稍后重试。

步骤 2：选择对应的系统版本

在页面中间找到 “Download the Arduino IDE”，点击下方的 “Windows Win 10 and newer, 64 bits” 链接：

✅ 如果你是 macOS 用户，请点击 macOS 版本；
✅ 如果你是 Linux 用户，请选择 AppImage 或 tar 包。

点击后会跳出捐赠页面，直接点击 “Just Download” 即可免费下载。

步骤 3：安装 Arduino IDE

下载完成后，双击运行安装程序（通常名为 arduino-ide_2.x.x_Windows_64bit.exe）
出现安装向导，点击 Next 继续
建议保持默认安装路径（或自定义到 D 盘）
勾选“创建桌面快捷方式”等选项，然后点击 Install
等待安装完成，点击 Finish 启动 Arduino IDE

步骤 4：首次启动设置

打开 Arduino IDE 后：

默认界面为英文，可在菜单中设置中文（目前仅部分版本支持）
左侧为项目资源管理器，右侧为代码编辑区
上方工具栏包含：上传（→）、编译（√）、串口监视器（放大镜）等按钮

✅ 到此，Arduino IDE 安装完成！你现在可以开始安装 ESP32 开发板支持包了！

二、在线安装 ESP32 开发板支持包

ESP32 是由乐鑫科技推出的一系列高性能 Wi-Fi + 蓝牙双模芯片，Arduino 官方平台并未内置 ESP32，需要手动添加开发板支持包。以下是在线安装的详细步骤。

步骤 1：打开 Arduino IDE 的“首选项”设置

启动 Arduino IDE
在菜单栏中点击：
File（文件） > Preferences（首选项）

💡 Windows 可直接使用快捷键 Ctrl + , 打开设置界面

在弹出的窗口中，找到 “Additional Board URLs”（附加开发板管理器网址）字段。

步骤 2：添加 ESP32 开发板索引地址

在“附加开发板管理器网址”中粘贴以下内容：

https://dl.espressif.com/dl/package_esp32_index.json

⚠️ 如果你已经添加过其他网址（如 ESP8266），请使用英文逗号 , 分隔多个网址。
输入补充地址，每行一个，最后是m5stack。

示例：

https://dl.espressif.com/dl/package_esp32_index.json,
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json, https://arduino.esp8266.com/stable/package_esp8266com_index.json
https://static-cdn.m5stack.com/resource/arduino/package_m5stack_index.json

然后点击 OK（确定） 保存设置。

步骤 3：打开开发板管理器并搜索 ESP32

点击菜单栏：
Tools（工具） > Board（开发板） > Board Manager（开发板管理器）
在搜索框中输入：
esp32
你将看到类似以下内容：

esp32 by Espressif Systems
最新版本：3.2.0
支持多种开发板（包括 DevKitC、NodeMCU、ESP32-C3、S3、S2、PICO 等）

步骤 4：选择版本并安装

点击该项右下角的“Install（安装）”按钮：

如果你希望安装稳定版，推荐安装 2.0.9
如果你希望体验最新版本（如支持 ESP32-S3 OTA、Matter 等），可以选择 3.2.0

📝 安装过程可能需要几分钟（依赖网络），会自动下载核心库、工具链等资源。

安装完成后，你将看到：

已安装 ✅ 提示
在 Tools > Board 中，你可以选择具体板型，例如：
ESP32 Dev Module
ESP32-S3 DevKit
ESP32-C3 DevKit
ESP32-WROOM 系列

🔧 补充建议

安装后可在菜单：Tools > Port（端口） 选择设备端口
建议安装 USB to UART 驱动（CH340、CP210x）

✅ 至此，你已经完成了 ESP32 在线安装配置！下一步将介绍如何“离线安装”开发板，适合网络不稳定或被墙用户使用。

三、离线安装 ESP32 开发板支持包

对于部分用户，Arduino IDE 在安装 ESP32 开发板时可能遇到 GitHub 访问失败、下载速度慢、无法联网等问题。为了解决这个问题，我们可以采用离线安装的方式。

本节提供安装说明和压缩包使用方法。

📦 提供的 ESP32 离线包版本

ESP32 2.0.9 离线包（适合大多数功能稳定需求）提取码: qpij
ESP32 3.2.0 离线包（截至 2025 年 5 月的最新版）
我想将3.2.0打包直接给你们，发现有5个G的大小太大了，还有另一种方法就是按照ESP32 2.0.9 离线包安装步骤，下载好2.0.9版本后，点开Arduino，找到esp32开发板选择最新版本3.2.0进行更新，成功率相比较直接下载高很多，但不保证100%的成功率。
如果想直接要3.2.0版本离线包的人很多，请在下面留言评论，如果人很多，我会考虑将其压缩上传到百度网盘中。

📝 请先下载对应的压缩包文件，文件名通常为：

esp32_package_2.0.9_arduinome.exe
3.2.0.zip

📦 📦 ESP32 2.0.9 离线包安装步骤

步骤 1：运行esp32_package_2.0.9_arduinome.exe

步骤 2：重启 Arduino IDE

完成上述操作后，关闭并重新打开 Arduino IDE。

然后进入菜单：

工具（Tools） > 开发板（Board） > ESP32 Dev Module

你应该可以看到完整的 ESP32 开发板列表了 🎉！

步骤 3：安装位置查找

——按键win+r，然后输入%LOCALAPPDATA%/Arduino15/packages会跳转到下载的位置
如：C:\Users\你的用户名\AppData\Local\Arduino15\packages\

📦 📦 📦 ESP32 3.2.0 离线包安装步骤

步骤 0：解压缩 ESP32 离线包

我想将3.2.0打包直接给你们，发现有5个G的大小太大了，还有另一种方法就是按照ESP32 2.0.9 离线包安装步骤，下载好2.0.9版本后，点开Arduino，找到esp32开发板选择最新版本3.2.0进行更新，成功率相比较直接下载高很多，但不保证100%的成功率。

如果想直接要3.2.0版本离线包的人很多，请在下面留言评论，如果人很多，我会考虑将其压缩上传到百度网盘中。

步骤 1：解压缩 ESP32 离线包

将下载好的 ZIP 压缩包解压，解压后应看到如下结构：

esp32/
├── boards.txt
├── platform.txt
├── cores/
├── tools/
└── variants/

步骤 2：创建 `hardware` 目录

打开你的 Arduino 用户文件夹路径，进入或创建以下目录：

Windows 系统：

C:\Users\你的用户名\AppData\Local\Arduino15\packages\esp32\hardware\esp32

macOS 系统：

💡 如果没有 hardware 文件夹，可以手动新建。

步骤 3：放入 ESP32 文件夹

将解压后的 esp32 文件夹放入以下目录中：

C:\Users\你的用户名\AppData\Local\Arduino15\packages\esp32\hardware\esp32

如果 espressif 文件夹不存在，请手动创建。

完整路径示例：

C:\Users\你的用户名\AppData\Local\Arduino15\packages\esp32\hardware\esp32\3.2.0

步骤 4：重启 Arduino IDE

完成上述操作后，关闭并重新打开 Arduino IDE。

然后进入菜单：

工具（Tools） > 开发板（Board） > ESP32 Dev Module

你应该可以看到完整的 ESP32 开发板列表了 🎉！

✅ 安装成功标志

可以在菜单中选择 ESP32 开发板（如：ESP32 Dev Module、ESP32-S3 DevKit）
可以在串口工具中看到对应端口（需要连接开发板）
编译示例程序不报错

📌 小技巧

可在菜单：文件 > 示例 > Examples from Custom Libraries 中看到 ESP32 示例
如果板子连接不上，可能需要安装 CH340、CP210x 驱动
如果你使用的是 ESP32-C3/S3，推荐使用 2.0.9 或以上版本

💡 离线安装不需要联网，适合实验室、内网、受限环境等，推荐下载多个版本备用。

四、常见问题与解决方案

无论是在线还是离线安装 ESP32 开发板，有时都会遇到各种问题。以下是使用 Arduino IDE 和 ESP32 常见问题的详细排查指南。

❓ 问题 1：开发板无法识别，端口（Port）菜单为空

🔍 原因分析：

数据线仅支持充电，不支持数据传输
未安装对应 USB 驱动（CH340、CP210x 等）
板子未正确连接 / 板载芯片损坏

✅ 解决方法：

更换一根 USB 数据线（确保支持传输）
安装对应驱动（根据芯片型号）：
- CH340 驱动下载（适用于 NodeMCU 类开发板）
- CP210x 驱动下载（适用于一些 DevKit 板）
换个 USB 接口，或重启电脑试试
使用其他 ESP32 开发板测试确认是否为板子硬件问题

❓ 问题 2：上传失败，报错 “Failed to connect to ESP32: Timed out…”

🔍 原因分析：

ESP32 未进入下载（Bootloader）模式
电源电压不足
驱动不兼容或串口占用

✅ 解决方法：

按住开发板上的 Boot 键不放，点击上传程序后等待 1 秒再松开
若依然失败，请尝试：
- 检查是否有串口监视器打开（占用了 COM 口）
- 更换 USB 接口
- 更换 IDE 或尝试使用 esptool.py 烧录

❓ 问题 3：安装成功，但开发板列表中没有 ESP32 选项

🔍 原因分析：

hardware 路径不正确
JSON 索引文件出错
离线包放错位置或未解压完整

✅ 解决方法：

确认路径是否为：
C:\Users\你的用户名\AppData\Local\Arduino15\packages\esp32\hardware\esp32
删除该目录，重新解压并放置一次
使用 Arduino IDE 的 Help > About 查看版本和加载状态

❓ 问题 4：编译报错 `xtensa-esp32-elf-g++ not found` 或 `toolchain missing`

🔍 原因分析：

离线包缺少工具链 tools/ 文件夹
安装不完整或被杀毒软件隔离

✅ 解决方法：

下载并确认压缩包中包含以下结构：

esp32/
├── tools/
│ └── xtensa-esp32-elf/
└── …

禁用安全软件后重新解压一次
或使用在线安装方式让 IDE 自动拉取工具链

❓ 问题 5：串口乱码 / 显示问号 / 无输出

🔍 原因分析：

串口波特率设置错误
程序未正确运行
ESP32 未上电 / 复位失败

✅ 解决方法：

确认串口监视器波特率为 115200（大多数 ESP32 示例使用该波特率）
添加串口输出测试代码：

void setup() {
  Serial.begin(115200);
  Serial.println("Hello from ESP32");
}
void loop() {}

3.尝试按一下 EN / RESET 按钮重新启动开发板
🛠️ 若以上方法均无法解决问题，请更换板子、尝试其他电脑，或使用 VS Code + PlatformIO 作为替代开发环境。

✅ 本节内容结束，下一部分将作为最后一节内容，包含：

附加资源推荐（中文论坛、下载镜像、示例项目等）
本教程总结与建议
（可选）如何备份/迁移 ESP32 安装

五、附加资源、总结与迁移建议

本教程帮助你从 0 开始，在 Arduino IDE 中成功安装 ESP32 开发板支持包，包括在线安装与离线安装两种方式，并处理常见问题。

以下为一些推荐资源、开发建议及迁移方法，供你进一步学习和优化开发环境。

📚 1. 官方与社区资源推荐

ESP32 Arduino 官方 GitHub
https://github.com/espressif/arduino-esp32
Arduino 中文社区论坛
https://www.arduino.cn
乐鑫技术文档中心（官方中文文档）
https://docs.espressif.com/projects/arduino-esp32/zh-cn/latest/index.html
ESP32 镜像源（加速访问）
可通过第三方镜像网站或 Gitee 镜像获取部分 JSON 索引和工具链（需手动验证安全性）