Arduino ESP32 开发环境搭建实操教程5 个关卡一次跑通首次点亮开发板【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32Arduino ESP32 开发环境 乐鑫官方核心包负责把熟悉的 Arduino 语法翻译给 ESP32 系列芯片听。本文带你依次完成装核心包、通串口、传固件、验输出 5 个关卡全程约 30 分钟终点是看到开发板的启动日志。开工前自检环境核对表四项全部满足再往下走核对项合格标准验证方式Arduino IDE1.8.x 及以上2.x 同样适用顶部菜单帮助 关于ESP32 开发板ESP32 / S2 / S3 / C3 / C6 等任意系列看芯片金属屏蔽罩上的丝印USB 数据线能传数据纯充电线不行拿手机连电脑试传文件网络与空间稳定网络 约 200MB 剩余空间浏览器能打开网页即可看磁盘剩余主线任务5 个关卡关卡 01IDE 装好 Arduino ESP32 核心包板子菜单出现预期产出工具 开发板菜单里出现 ESP32 Dev Module 条目。执行步骤打开文件 首选项macOS 为Arduino 首选项在底部Additional Boards Manager URLs输入框填入官方索引地址https://espressif.github.io/arduino-esp32/package_esp32_index.json点OK。看到重新打开窗口后地址仍在输入框即通过。打开工具 开发板 开发板管理器搜索框输入esp32。看到条目 esp32 by Espressif Systems 出现即通过。选中该条目点Install等待进度条走完约 200MB视网络耗时 5~10 分钟。看到条目显示Installed即通过。查看工具 开发板。看到 ESP32 Dev Module 等条目出现本关通过。 下载受限时把索引地址换成官方文档里的-cn镜像地址即可操作完全相同。排错速查现象大概率原因处置搜索不到 esp32索引地址没保存成功或网络受限重新打开首选项确认地址仍在并点过 OK仍不行走关卡 02进度条转圈后失败网络不稳产生半成品删掉已下载内容重装别原地续传关卡 02网络受限时手动装好核心包预期产出tools目录下出现dist与sdk两个子目录IDE 板子菜单同步出现条目。执行步骤在电脑任意目录执行克隆命令看到仓库完整下载完成即通过git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32把克隆目录整体挪到 sketchbook 的hardware/espressif下文件夹命名为esp32。看到最终层级是hardware/espressif/esp32即通过IDE 只认这个层级。进入esp32/tools目录执行python get.pyWindows 用户直接双击get.exe看到脚本下载完约 200MB 工具链即通过。检查tools目录。看到dist和sdk两个子目录同时出现本关通过。排错速查现象大概率原因处置get.py 报 SSL 证书错误系统时间不对或证书环境缺失把系统时间设为自动同步重跑脚本克隆完 IDE 仍找不到板子目录层级放错逐层核对路径必须是 espressif 下直接放 esp32️ sketchbook 位置就在首选项窗口的 Sketchbook location 那一行。关卡 03打通串口端口列表出现 COM 口预期产出工具 端口里出现稳定串口条目拔线即消失。执行步骤换一根确认能传数据的线手机试传文件验证把开发板连上电脑。打开设备管理器Windows或查看/dev/tty*Linux / macOS。看到端口下出现新设备即通过。若出现带黄色感叹号的未知设备确认它是 CH340 还是 CP210x 芯片从芯片厂商官网下载对应驱动装完重插 USB。重启 IDE打开工具 端口。看到COM3Windows或/dev/ttyUSB0这类条目出现且拔掉 USB 后条目消失本关通过。排错速查现象大概率原因处置端口列表一直为空线材只能充电或缺 CH340/CP210x 驱动换线重装驱动设备管理器有未知设备就是驱动没装好上传报 Could not open COM3端口被串口监视器或其他软件占用关掉占用程序再重试✅ 判断线材问题最快的土办法同一根线插手机连电脑能传文件说明线没问题问题必在驱动。关卡 04固件上传成功日志出现 Hash 校验通过预期产出上传日志滚出写盘进度末尾出现Hash of data verified.板子自动重启。执行步骤工具 开发板选择与芯片丝印一致的条目如 ESP32 Dev Module。核对Flash Size与板载闪存一致常见 4MB / 8MB要跑摄像头、LVGL 这类内存大户把Partition Scheme换成更大 app 分区的方案。点顶部上传箭头。若卡在Connecting...别慌按住板子BOOT键出现连接提示后松开。看编译上传日志。看到Writing at 0x...进度滚完且末尾出现Hash of data verified.本关通过。排错速查现象大概率原因处置Failed to connect没找到串口或端口被占用关掉串口监视器、重插 USBTimed out waiting for packet header板子没进下载模式按住 BOOT 键再点上传Invalid head of packet波特率或接线不稳把Upload Speed从 921600 降到 115200IDE 怎么都失败时的终极兜底用核心包自带的 esptool 手动烧录esptool.py --chip esp32 --port COM3 --before default_reset --after hard_reset write_flash -z 0x1000 your_firmware.bin看到命令输出末尾出现Hash of data verified.即通过。关卡 05串口监视器出现启动日志预期产出板子重启后 3 秒内串口监视器里出现持续滚动的启动日志。执行步骤打开工具 串口监视器波特率设为 115200。按一下板子RESET键触发重启。看到 3 秒内出现持续启动输出本关通过。排错速查现象大概率原因处置监视器完全没输出波特率不对或 TX/RX 接反确认 115200USB 直连板子重启再看一次有输出但全是乱码波特率设置与固件不匹配改回 115200 再试通关验收3 条硬指标✅ 上传日志包含Hash of data verified.且上传结束后板子自动重启✅ IDE工具 端口有串口条目拔掉 USB 后条目消失✅ 串口监视器115200 波特率在板子上电 3 秒内有持续启动输出三条都过说明取核心 → 通串口 → 选配置 → 传固件 → 验结果整条链路没有断点。方案选型横向对比方案机制/原理适用场景前提条件IDE 开发板管理器安装按索引地址自动下载工具链网络正常时的日常首选索引地址已保存手动克隆仓库安装git 拉源码 get.py 拉工具链网络受限、管理器下载总失败本地已装 Git 与 Pythonesptool 命令行烧录直接指定芯片、端口、地址写 FlashIDE 反复失败的兜底刷机核心包已装好自带 esptoolOTA 无线升级浏览器访问板子 IP 上传新固件板子已部署、接线不便先用 USB 烧入带 OTA 功能的固件避坑手册误区 vs 事实误区端口列表是空的说明开发板坏了。 事实绝大多数是只能充电不能传数据的线材或缺 CH340/CP210x 驱动板子本身没坏。误区上传失败就多试几次连着点上传没问题。 事实端口被串口监视器占着时开着监视器重试永远报 Failed to connect必须先关监视器。误区分区方案用默认的就行不影响运行。 事实摄像头、LVGL 这类内存大户用默认小分区会反复重启要在Partition Scheme里换大分区方案。高频问答 FAQ为什么开发板管理器里搜不到 esp32先确认首选项中已填索引地址并点过OK仍搜不到就检查网络或代理设置也可以改用手动克隆安装的方式。为什么之前上传正常突然就失败了大概率是端口被串口监视器占用或板子没进下载模式。先关掉监视器再按住 BOOT 键重试一次。烧录成功但串口监视器没输出怎么办检查波特率是否为 115200再看板子 TX/RX 是否接反USB 直连的板子重启一下看有无日志。OTA 升级需要改代码吗需要。第一次仍要用 USB 烧入带 OTA 功能的固件之后才能走无线升级。分区方案一定要改吗跑 Blink 这类小程序不用改要跑摄像头、LVGL 等内存大户必须换大 app 分区方案否则反复重启。下一步装核心包 → 通串口 → 选配置 → 传固件 → 验输出五关跑通后直接打开 libraries/WiFi/ 或 libraries/Wire/ 下的现成示例连上 Wi-Fi、点亮第一个外设。延伸阅读安装文档各系统的官方安装步骤与索引地址入门指南核心功能与完整 API 说明内置库示例目录WiFi、BLE、WebServer 等现成例程排障手册常见编译、上传、调试问题的官方处置【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考