15 分钟搞定 ESP32 Arduino 开发环境新手完整避坑指南【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32开发板管理器里搜不到 ESP32找不到开发板是第一次用 arduino-esp32ESP32 芯片的官方 Arduino 核心让 Arduino IDE 直接为 ESP32 写程序、编译、上传时最集中的两个抱怨。整个搭建流程只有 3 件事添加开发板管理器地址、安装核心库、用 WiFi 扫描验证全程约 15 分钟。ESP32 环境准备系统、线材、网络检查清单✅ 系统Windows 必须 64 位32 位与 Win7 已不受支持macOS 10.12 以上Ubuntu 16.04 以上✅ 开发板任意 ESP32 模组都行推荐引脚全出的 DevKitC✅ 数据线必须是 USB 数据线只供电的充电线是找不到开发板的头号原因 ✅ 网络核心库体积大下载时保持网络稳定✅ Arduino IDE先装最新版1.8 及以上没有它就没有开发板管理器 动手前先做线材识别测试插上开发板打开 IDE 的串口下拉框。出现新的 COM 口Linux 为 /dev/tty*说明电脑已识别开发板再往下进行。添加 ESP32 开发板管理器地址按网络情况二选一ESP32 核心不是 Arduino IDE 自带的要先告诉 IDE 去哪里找。这个地址只有一个 URL方案 A默认→ 官方稳定版地址https://espressif.github.io/arduino-esp32/package_esp32_index.json方案 B下载慢、不稳定→ arduino-esp32 项目提供的国内镜像https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json添加方式File → PreferencesmacOS 在顶部菜单 Arduino → Settings→ 把地址粘进 Additional Boards Manager URLs 一栏 → 保存。⚠️ 用方案 B 装上的核心库版本号带 -cn 后缀它不支持自动更新以后升级要在开发板管理器里手动选 -cn 版本否则更新必然失败。完整安装细节见 docs/en/installing.rst。接着让开发板管理器干活Tools → Board → Boards Manager → 搜 esp32 → Install。装完做两件事Tools → Board 选中你的实际型号如 ESP32 Dev Module然后重启 IDE——不重启板型列表不会刷新。用 WiFi 扫描验证 ESP32 开发环境 最简单的验证不需要额外硬件扫描周边 WiFi。直接打开 IDE 自带例程File → Examples → WiFi → WiFiScan或写下面这段十几行的最小代码能编译上传就说明环境通了。#include WiFi.h void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); } void loop() { Serial.println(Networks: String(WiFi.scanNetworks())); delay(5000); }打开串口监视器底部波特率也选 115200——两端不一致就不会有输出。看到数字即成功显示 0 说明 WiFi 模块正常只是当前环境没扫到网络隐藏 SSID、离路由器太远不是环境问题。ESP32 上传报错速查症状 → 排查 → 解决 症状先查什么解决找不到开发板串口下拉框有没有新 COM 口换数据线、换 USB 口、装 USB 驱动开发板管理器搜不到 esp32地址是否保存、IDE 是否重启换国内镜像地址重试编译出一串红字报错第一行板型与实际芯片一致S3 模组不能选原版 ESP32串口在但上传失败板子是否需要按住 BOOT 键进入下载模式按住 BOOT 再点上传结束后松开症状串口在、上传却始终失败→ 排查部分开发板只有按住 BOOT 键才会进入下载模式同时确认 USB 口是否被其他设备占用。 → 解决按住 BOOT → 点上传 → 松开仍失败就换电脑主板后置 USB 口再试。其余疑难杂症官方 FAQ 里有现成答案docs/en/faq.rst。搭建之后OTA 免数据线更新固件 ESP32 支持 OTAOver-The-Air空中升级第一次用 USB 上传后之后的代码改动走 WiFi 推送不用再插数据线。IDE 自带例程 OTAWebUpdater上传后在浏览器打开 esp32.local用默认账号 admin/admin 登录即进入更新页面完整流程见 docs/en/ota_web_update.rst。环境已经就绪接下来做三件事编译上传 WiFiScan 例程确认串口出现网络数量改为你家 WiFi 的 SSID 和密码确认开发板能拿到 IP跑一遍 OTAWebUpdater 例程体验浏览器里更新固件【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考