企业官网建设流程全解析

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 IDE：1.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 保存后重启 IDE：

https://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
• 换完地址后关闭板卡管理器窗口，重新打开再搜一次，列表加载慢就多等一两分钟

Q：Linux 上编译报 "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