Arduino ESP32 从零搭建：5 步完成核心包安装、串口识别与首次上传

Arduino ESP32 从零搭建：5 步完成核心包安装、串口识别与首次上传

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

这份指南写给刚收到第一块 ESP32 开发板、准备接触 Arduino IDE 的人。按顺序做完，你会完成 Arduino ESP32 核心包安装、串口识别和首次上传，并学会后续连 Wi-Fi 与更新固件；中途卡住，对照故障表逐项查。

路线总览：核心包安装 → 串口识别 → 首次上传 → Wi-Fi 连接 → 固件迭代。

开工前自检：备好这张清单再动手

安装 ESP32 核心包：让板型出现在开发板列表

没有核心包，IDE 根本不知道怎么驱动 ESP32——相当于新同事入职没给岗位说明书，什么都安排不了。这一步验证的就是：板子能不能被 IDE"看见"。

1. 打开文件 > 首选项，在最下方的Additional Boards Manager URLs输入框填入官方索引地址，点 OK。

2. 进入工具 > 开发板 > 开发板管理器，搜索esp32，选中最新版点 Install，包约 200MB，等下载跑完。

3. 管理器一直转圈下不动时，改走命令行：把源码拉到本地，再自动下载工具链（编译器、烧录器等辅助工具）：

git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32 cd arduino-esp32 && python3 tools/get.py

验收：✅工具 > 开发板里出现"ESP32 Dev Module""ESP32S3 Dev Module"等一整排条目，管理器中 esp32 条目标记为已安装。

卡住了：回到文件 > 首选项确认 URL 填了、按了 OK；还不行就重启 IDE。

认出板子：串口与芯片型号对上，首次上传跑通

这一步验证电脑到板子的完整通路：端口冒出来说明驱动没问题，上传跑完说明链路全通。

1. 插上 USB 线，查看工具 > 端口：出现COM3（Windows）或/dev/ttyUSB0（Linux/macOS）一类的条目即识别成功。

2. 在工具 > 开发板按芯片丝印选对应型号（ESP32 Dev Module、ESP32S3 Dev Module 等），并把Flash Size调到与硬件一致（常见 4MB / 8MB / 16MB）。型号拿不准时，对照官方引脚图核对丝印与引脚布局：

3. 打开文件 > 示例 > 基础 > Blink，点工具栏上传箭头（→）。首次会先编译再烧录，日志里Writing at 0x0000...一路涨到 100% 就说明写得进去：

验收：✅ 板载 LED 以 1 秒为周期一闪一灭；打开工具 > 串口监视器、波特率选 115200，能看到滚动启动日志。

卡住了：按住板子上的BOOT键再点上传，出现连接提示后松开。

补充提示：

• 端口列表一直是空的：多为缺 CH340/CP210x 驱动或线是充电线，先看设备管理器里带感叹号的设备。
• 之前能传、突然不行：九成是端口被串口监视器占着，关掉监视器、按住 BOOT 重传。
• 烧录成功但串口没输出：确认波特率是 115200，再看 TX/RX 有没有接反。

把板子接上网：连上家里路由器拿到一个 IP

ESP32 最大的价值是板载 Wi-Fi。"Station 模式"可以理解成新租户入住：先过路由器的"密码关卡"，才能领到自己的"房号"（IP）。这一步验证板子能否真正连进家里的网络。

1. 打开文件 > 示例 > WiFi > WiFiClientConnect（核心包 libraries/WiFi/ 自带的例程）；

2. 把代码里的ssid和pass改成自己路由器的 Wi-Fi 名和密码；

3. 上传后打开串口监视器，观察输出。

验收：✅ 串口先打印WiFi connected，随后出现一个192.168.开头的 IP。

卡住了：用同一例程里的WiFi.scanNetworks()扫一遍周围网络，看自己的路由器在不在列表里，先排除密码打错。

首次跑通之后：3 种免插线更新固件的路子

烧进去只是开始，日常迭代不必反复拔线。USB 直连是开发期用得最多的一条路：改完代码直接点上传，和上一步完全一样。下面两条路留给板子已联网、或离电脑较远的场合。

OTA 空中升级

第一次仍要靠 USB 烧入带 OTA 功能的固件（可参考 libraries/ArduinoOTA/ 与 libraries/WebServer/ 中的例程）。之后在浏览器里打开板子的 IP，登录页面上传新固件即可：

验收：✅ 升级完成后串口打印出新固件的版本号或启动信息，全程没碰过 USB 线。

卡住了：先确认当前烧录的固件确实带 OTA 功能——首次烧录时没带，无线这条路打不开。

USB MSC 虚拟 U 盘模式

部分开发板支持把自己伪装成 U 盘：把编译好的.bin拖进盘符，设备自动重启完成更新。

验收：✅ 设备重启后，串口打印出新版本的启动信息。

卡住了：先确认所用开发板型号支持 MSC 模式，不支持就走 OTA 或 USB 直连。

上传失败故障对照表：看日志 30 秒自查

收尾：把整条路线再走一遍

核心包安装 → 串口识别 → 首次上传 → Wi-Fi 连接 → 固件迭代，上面每处验收都确认过了，就可以动手做下一个项目。

延伸阅读：

• docs/：官方文档，安装指南与各外设教程
• tools/：espota.py、flasher.py 等烧录与构建脚本
• libraries/WiFi/：Wi-Fi 例程库，覆盖 STA/AP/扫描等用法
• libraries/ArduinoOTA/：OTA 升级相关例程

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