保姆级 arduino-esp32 安装指南：零基础 ESP32 开发环境 10 分钟跑通-编程实验室

保姆级 arduino-esp32 安装指南：零基础 ESP32 开发环境 10 分钟跑通

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

你大概率遇到过这种情况：ESP32 板子刚插上，Arduino 里提示找不到开发板，第一次上传就卡在"未知端口"上，一下午就耗没了。这篇带你把官方 arduino-esp32 核心支持的配置一步步走完，从装 IDE 到第一次上传成功，全程照着点，10 分钟内能跑通。

开工前自检

5 条都满足再动手，后面不会卡：

✅ 系统是 64 位 Windows、macOS 10.12 以上或 Ubuntu 16.04 以上
✅ 手头有 ESP32 系列开发板（ESP32 / S2 / S3 / C3 都适用）
✅ USB 线是数据线，只充电的线是"找不到开发板"的头号原因
✅ 网络正常，开发板包下载大约 100MB
✅ Arduino IDE 里没装过旧版 arduino-esp32（装过先卸载）

环境细节拿不准的，可以先翻官方安装文档对照一下。

主流程：按顺序做这 5 件事

第1步｜安装 Arduino IDE

去 Arduino 官网下载最新版的 Windows / macOS / Linux 安装包，一路默认设置装完即可。

确认信号：IDE 打开后，Tools → Board菜单里能看到"Arduino Uno"，界面不报错。

⚠️ IDE 版本要求 1.6.4 以上，低于这个版本开发板管理器装不了第三方包，直接换新版本。

第2步｜添加 ESP32 开发板仓库地址

打开File → Preferences（macOS 在 Arduino 菜单下），在Additional Boards Manager URLs输入框里填入：

https://espressif.github.io/arduino-esp32/package_esp32_index.json

点OK保存。

确认信号：设置框里完整显示这条地址，没有多字少字。

⚠️ 这个框只需这一条链接，别往里塞一串地址——空格会被一起带进去导致链接失效，后面开发板管理器会一片空白。

第3步｜开发板管理器里安装 esp32 包

进入Tools → Board → Boards Manager，搜索框输入esp32，找到esp32 by Espressif Systems这一项，点Install。

确认信号：进度条跑完后，列表里出现"esp32"条目，旁边带已安装标记。

⚠️ 这个包约 100MB，下载慢时别关 IDE；中途超时直接再点一次 Install 重试就行。

第4步｜选中你的开发板和串口

Tools → Board里选与手头板子匹配的型号，比如 ESP32 Dev Module、ESP32-S3 Dev Module；再在Tools → Serial Port里选出现的串口号。

确认信号：两个菜单都回显你选中的条目，不是问号也不是空白。

⚠️ 串口列表是空的：Windows 通常要先装 USB 转串芯片驱动（CP210x 或 CH340），macOS 和 Linux 一般插板即现。

第5步｜编译并上传第一个程序

新建草图（File → New Sketch），把下面验证段落的代码贴进去，点 IDE 左上角的上传按钮（右箭头图标）。

确认信号：底部输出出现 "Hard reset done" 或 "New EEPROM written"，没有红色报错。

⚠️ 部分板子不会自动进下载模式：按住板上的BOOT键，点上传，等一两秒再松开。

跑通确认：最短验证

把下面两个变量改成你自己的 WiFi 名称和密码，其余不用动：

#include <WiFi.h> const char* ssid = "你的WiFi名称"; const char* password = "你的WiFi密码"; void setup() { Serial.begin(115200); WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println(WiFi.localIP()); } void loop() {}

打开串口监视器，右下角波特率选115200。连接正常的话，会先刷出一串点，最后打印出类似192.168.1.x的内网 IP。

看到 IP 就说明环境全通了 ✅ —— 此后仓库里任何例程都能直接编译上传。