15 分钟跑通 ESP32 开发环境零基础也能完成的 arduino-esp32 五步配置【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32这篇文章面向没有任何编程基础的读者手把手带你在 Arduino IDE 里安装 arduino-esp32 核心包让 ESP32 开发板第一次完成 WiFi 扫描程序的上电运行。全程只有 5 个步骤每一步都给出了明确的成功了信号照着做大约 15 分钟能跑通。动手前的两件事下面这些条件缺一不可缺了后面全都要卡住电脑Windows 10/11 64 位、macOS 或 Ubuntu/Fedora 等 Linux 发行版ESP32 核心 v2 以上不支持 32 位 Windows 和 Win7 及更早系统Arduino IDE1.8 以上的任意版本IDE 2.x 也可以从 Arduino 官网下载一块 ESP32 开发板ESP32 DevKitC、WeMos D1 MINI ESP32 等常见型号均可一根能传数据的 USB 线只带电源线、没有数据线的充电线不行这是最常见的隐形坑网络稳定安装核心包时要下载数百 MB 文件分步操作第 1 步安装 Arduino IDE从 Arduino 官网下载最新版一路默认选项装完即可。装好先双击打开一次看到主界面能正常出现代码编辑区就算过关然后关掉它。第 2 步在偏好设置里添加 ESP32 板卡管理器地址这一步是整个流程里最容易翻车的地方地址没加对板卡管理器里就永远搜不到 esp32。打开 File Preferences 菜单在底部的 Additional Boards Manager URLs 输入框里粘贴稳定版仓库地址点 OK 保存后重启 IDEhttps://espressif.github.io/arduino-esp32/package_esp32_index.json验证信号重新打开偏好设置能看到刚才填的地址还在输入框里。如果网络环境不稳定可以换用文末 FAQ 里给的国内镜像地址。✅第 3 步在板卡管理器中安装 esp32 核心包进入 Tools Board Boards Manager 菜单在顶部搜索框输入 esp32找到由 Espressif Systems 发布的 esp32 条目。版本下拉框里选一个不带 alpha、beta 字样的稳定版本号点 Install。验证信号下载安装完成后esp32 条目的 Install 按钮变成了 Remove 按钮。第 4 步选择开发板和串口用 USB 线把开发板插到电脑上。打开 Tools Board 菜单选中 esp32 ESP32 Dev Module如果你的板子不是这个型号就按板子名称选对应的条目比如 WeMos D1 MINI ESP32。然后打开 Tools Port选中插板后新出现的那个串口Windows 上一般是 COM 开头Linux 和 macOS 上是 /dev/ttyUSB 或 /dev/ttyACM 开头。验证信号把板子拔下再插上串口列表里那个端口随之消失和出现选它就不会错。不确定板子上哪个脚是哪个可以对照官方 DevKitC 引脚图熟悉一下 GPIO 编号和 BOOT、EN 按键位置。第 5 步上传 WiFi 示例并验证在 File Examples WiFi WiFiScan 菜单打开官方自带的 WiFi 扫描示例不用自己写一行代码。点左上角的上传箭头等待编译和上传完成。上传成功后打开 Tools Serial Monitor把右下角波特率下拉框设为 115200。验证信号串口窗口里滚出 Scan done 字样随后是一列附近 WiFi 的名称、信号强度和信道。能看到你自己家路由器的名字说明环境已经彻底跑通。卡住了看这里Q上传时提示 Failed to connect to ESP32: Timed out waiting for packet header快速判断法板子没进下载模式或者 USB 线是只充电不传数据的线。点上传的同时手指按住板子上的 BOOT 键在 EN 键旁边几秒后再松开换一根确定能传数据的 USB 线手机原装线一般可以并且直插电脑 USB 口别走 USB 集线器如果板子还接了外部电源先断开外部供电只用 USB 供电再试Q板卡管理器刷新后依然搜不到 esp32快速判断法地址没存进偏好设置或者当前网络访问不了官方地址。重新打开 File Preferences确认 Additional Boards Manager URLs 里地址还在把地址换成国内镜像https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json换完地址后关闭板卡管理器窗口重新打开再搜一次列表加载慢就多等一两分钟QLinux 上编译报 python: executable file not found in $PATH快速判断法系统里只装了 python3没有 python 这个命令名。终端执行sudo apt install python-is-python3装完重新编译即可更多编译和上传相关的报错关键词可以在官方排错文档 docs/en/troubleshooting.rst 里检索对照。收尾与下一步当串口监视器里能刷出 WiFi 列表环境搭建就真正完成了arduino-esp32 核心包把 ESP32 全家桶芯片的编译工具链、WiFi/BLE/外设驱动都打包好了从这一刻起你写的任何 Arduino 程序都能上传到板子上跑。接下来可以顺着两条线走一条是网络方向把 WiFiScan 示例里的扫描逻辑换成连接自家路由器的连接逻辑libraries/WiFi/ 目录下还有一批现成的网络示例可以照着改另一条是外设方向BLE、SPI、I2C 这些官方示例同样在 File Examples 菜单里打开就能直接上传体验。想深入了解各种安装方式的差异可以再翻翻安装文档 docs/en/installing.rst。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考