10分钟装通ESP32开发环境：别再跟进度条死磕

10分钟装通ESP32开发环境：别再跟进度条死磕

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32

开发板管理器里，进度条卡在 83% 十分钟没动，弹窗底部一行小字写着 Failed at step uploading。你已经点了三次刷新，Arduino ESP32 开发环境（ESP32 芯片的官方支持包）就是装不进去。

为什么会装不上

装不上基本逃不出下面三个原因，每个花一分钟想明白，后面就不慌了。

网络够不到官方下载源

ESP32 核心包（芯片厂商维护的官方支持包）托管在境外的服务器上，安装时要完整拉下几百 MB 的工具链。你的链路一抖或者被拦截，进度条就停在某个百分比上，怎么刷新都不再走。

残留缓存占着安装位

上次失败后，IDE 会在.arduino15目录（存放已下载包和安装中文件的用户目录）留下没下完的半截文件，其中 staging 目录（相当于下载的"中转站"，装完就没用了）最容易留残。你重装时 IDE 会直接复用这些坏文件，于是同样的错误原样再演一遍，看起来就像"重装也没用"。

装的版本和板子对不上

开发板包分稳定版和开发版两种，开发版带 alpha 后缀、没经过完整测试。装错版本后，编译时会冒出一堆莫名其妙的报错，看着像代码写坏了，其实是平台和你的板子不匹配。

一次装对的完整流程

四个步骤，全程不超过十分钟。之前失败过的话，一步都别省。

Step 1｜把官方包地址填进首选项

• 去哪里：文件 → 首选项，找到 Additional Boards Manager URLs（附加开发板管理器网址）一栏。
• 做什么：填入官方索引地址https://espressif.github.io/arduino-esp32/package_esp32_index.json，点 OK 保存。地址可以填多个、用逗号隔开，这里只需要一个。
• 看到什么算成功：重新打开首选项，地址还停在输入框里没丢。

首选项窗口里，把 ESP32 官方包地址填进 Additional Boards Manager URLs 一栏

Step 2｜清掉上次失败的残留文件⚠️

• 去哪里：完全退出 Arduino IDE，打开主目录下的.arduino15文件夹（Windows 在C:\Users\你的用户名，macOS 和 Linux 在用户主目录，看不到就在文件管理器里开启"显示隐藏文件"）。
• 做什么：删掉staging/packages和packages/esp32两个文件夹；本来就没有就跳过。
• 看到什么算成功：目录里翻不到半个 esp32 文件夹。

跳过这步是"重装没用"的头号原因——坏缓存被 IDE 复用，报错只会原封不动再来一遍。

Step 3｜在开发板管理器里安装 esp32 包

• 去哪里：工具 → 开发板 → 开发板管理器，搜索框输入 esp32。
• 做什么：选中 "esp32 by Espressif Systems"，确认右侧版本框里不带 alpha 字样，点 Install。
• 看到什么算成功：进度条走完，Install 按钮变成 Installed。

开发板管理器里搜索 esp32，选中 Espressif Systems 发布的包点安装

💡 网络长期连不上官方源，就把 Step 1 的地址换成国内镜像https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json，安装时选带 -cn 后缀的版本。

Step 4｜选定开发板型号和串口

• 去哪里：工具 → 开发板 → ESP32 Arduino，再切到工具 → 端口。
• 做什么：开发板选 "ESP32 Dev Module"（其他型号选对应的名字），端口选插上板子后新冒出来的那一项——Windows 上是 COM 口，macOS 和 Linux 上是 /dev/tty 开头。
• 看到什么算成功：拔掉板子这一项消失、插上又出现，说明没选错。

端口列表里什么都没新出现？Windows 上多半是缺 CH340 或 CP2102 串口驱动（板子上 USB 转串口芯片的驱动），装完驱动再插一次板子。

ESP32 DevKitC 的引脚布局，选开发板时对照手头的板子确认型号

怎么确认它真能跑了

三步出结果，一分钟见分晓：

1. 文件 → 示例 → 01.Basics → Blink，打开官方灯语示例。
2. 点左上角"验证"按钮，等状态栏跳出 Done compiling。
3. 点"上传"，传完看板子上的小灯开始一灭一亮。

// Blink 的核心逻辑，跑通它环境就全通了 void setup() { pinMode(LED_BUILTIN, OUTPUT); } void loop() { digitalWrite(LED_BUILTIN, HIGH); // 点亮 delay(1000); digitalWrite(LED_BUILTIN, LOW); // 熄灭 delay(1000); }

灯一眨，环境就通了。灯不亮先查三样：端口、板子型号、板子有没有真的通电。

IDE 里打开 Blink 示例，编译通过、上传成功就说明 ESP32 开发环境装好了

下次别再踩的坑

装完之后往哪走

环境通了，剩下的活儿就是玩硬件。官方示例放在 libraries/ESP32/examples/，从网络到传感器按目录翻就行；想系统补基础，docs/en/tutorials/ 里的教程从 GPIO 点到 Wi-Fi 连接都有。

装好 ESP32 开发环境后，板子就能像这样以 Wi-Fi 客户端身份连上家里的路由器

灯亮了，去搞你的第一个项目吧。

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32