15分钟搭好ESP32 Arduino开发环境:3个阶段完成arduino-esp32安装并跑通第一段代码
2026/9/10 13:13:49 网站建设 项目流程

15分钟搭好ESP32 Arduino开发环境:3个阶段完成arduino-esp32安装并跑通第一段代码

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

卡在半路装不上驱动、板子选不对、上传永远失败?这篇文章带你用 arduino-esp32 官方核心包,在15分钟内完成 Arduino IDE 的 ESP32 支持安装,并把第一段 WiFi 代码真正烧进开发板。全程只有3个阶段,每个阶段都有明确的"做到哪一步算完成"的标志。

动手前的一次性准备

先把下面这张清单核对一遍,缺一项都会让后面的步骤卡住:

  • 64位 Windows、macOS 或 Linux 系统(Windows 32位和 Windows 7 以下已不被 v2.x 核心支持)
  • 从 arduino.cc 官网安装的 Arduino IDE,版本 1.8 及以上
  • 一块 ESP32 系列开发板(ESP32 / S2 / S3 / C3 / C6 等均可),稳定版已覆盖这8款 SoC
  • 一根能传数据的 USB 线(只充电的线传不了数据,换了线问题往往直接消失)
  • 可用的 WiFi 网络及密码,验证环节要用

主线操作:给Arduino IDE装上ESP32支持

阶段一:把ESP32官方仓库地址加进Board Manager

打开 Arduino IDE,点 File → Preferences(macOS 上在顶部菜单 Arduino → Settings)。找到Additional Boards Manager URLs输入框,把稳定版仓库地址粘贴进去:

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

如果输入框里已有其他地址,用英文逗号隔开再追加,不要覆盖。点 OK 保存。

这一步完成的标志:输入框里能看到刚粘贴的完整地址,且没有多余空格。

⚠️ 卡在这?

  • 地址末尾必须完整落在.json上,少打一个字母后面搜索都会失败
  • 国内网络拉取该地址慢或超时,可临时换个网络环境再点 OK

阶段二:在Boards Manager里安装esp32平台包

打开 Tools → Board → Boards Manager,在搜索框输入esp32,结果里会出现esp32 by Espressif Systems。点右侧 Install,装稳定版版本号,不要装带 dev 后缀的开发版。

包体有几百兆,进度条会走几分钟。这一步完成的标志:esp32 条目右侧从 Install 变成Installed,并显示已安装版本号。

⚠️ 卡在这?

  • 进度条卡死或报错:关闭管理器窗口,重新打开 Boards Manager 再点一次 Install
  • 之前装过旧版本:先选中旧版点 Remove,装干净后再装新版
  • 安装中不要关闭 IDE,中途断掉需要整个包重下

装完后重启一次 Arduino IDE,让工具链生效。

阶段三:选对板型和串口,完成首次编译上传

重启后做三件事:

  1. Tools → Board 里选中你的实际板子,最常见的入口是ESP32 Dev Module,对应板上丝印是 ESP32-D0WD 之类的型号
  2. Tools → Port 里选中刚才插板子后新出现的串口(Windows 上是 COM 口,Linux/macOS 上是 /dev/ 开头的设备)
  3. 点左上角对勾 Upload 按钮上传一个示例:File → Examples → ESP32 → Bluetooth → Blink,或直接编译(Ctrl/R + R)确认无报错

这一步完成的标志:底部输出区打印Hard resetting via RTS pin...且没有出现Error红字。

⚠️ 卡在这?

  • Tools → Port 里没有新串口:先换 USB 口和 USB 线,Windows 还需等待 CH340/CDC 驱动自动装完
  • 上传停在Connecting...____不动:按住板上的 BOOT 键再按一下 RESET,让芯片进下载模式,然后立即点 Upload
  • 串口监视器乱码:关闭其他占用串口的程序,把波特率设为 115200

跑通验证:用一段WiFi扫描代码确认环境就绪

现在写一段最短的验证代码,新建文件粘贴下面这段,Upload 后打开 Serial Monitor(波特率 115200):

#include <WiFi.h> void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); } void loop() { int n = WiFi.scanNetworks(); Serial.print("发现 "); Serial.print(n); Serial.println(" 个WiFi网络"); delay(10000); }

预期结果:每10秒输出一行发现 N 个WiFi网络,N 是你周围真实存在的 AP 数量(通常 5~30 个)。只要这个数字在持续刷新,说明核心、WiFi 驱动、串口全链路都通了。

进阶玩法:OTA无线更新与开箱即用的库生态

环境搭好后,最值钱的两个能力直接可用:

  • OTA 无线更新:板子部署后不用拔 USB 线,通过浏览器登录http://esp32.local就能上传新固件,示例工程 OTAWebUpdater 自带登录页和上传表单,流程见 OTA Web Update 文档
  • 完整库生态:仓库自带 WiFi、BLE、ESP-NOW、Zigbee、Matter、USB、SD/LittleFS 等40多个库,libraries/ 目录下每个库都配了示例,File → Examples 里直接能翻到。各 SoC 支持哪些外设,官方库支持矩阵 一张表说清楚

下一步:别停在验证,直接做你的第一个项目

到这里,环境部分你已经全部做完:核心装好、板子能识别、代码能上传、WiFi 能跑通。剩下的只是创意问题。现在就打开 File → Examples → ESP32 → WiFi → WiFiScan 上传运行一遍,或者新建一个 sketch,把扫描到的 SSID 打印成完整列表——你的第一个 ESP32 项目从这一行代码开始。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询