企业官网建设流程全解析

Arduino ESP32 核心库：15 分钟完成 ESP32 开发环境搭建与串口验证

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

Arduino ESP32 核心库（本仓库）把 Espressif ESP32 系列芯片接入 Arduino 生态：用熟悉的setup/loop就能写 WiFi、蓝牙、传感器程序。按本文三个检查点操作，约 15 分钟即可编译并上传第一个验证程序。

三问自检：ESP32 开发环境的前置条件

动手前先确认三件事，任何一问答"否"，先按替代方案处理再往下走。

1. 操作系统是 64 位 Windows、macOS 或 Linux 吗？否 → 停止。ESP32 核心 2.x 之后已不再支持 32 位 Windows 和 Win7 及更早系统，换一台 64 位机器。

2. 手头有一块 ESP32 开发板和一根能传数据的 USB 线吗？否 → 开发板认准 ESP32 系列（如 ESP32 Dev Module、C3/S3 各型号）；USB 线必须是数据线，纯充电线会让端口列表里永远不出现 COM 口。

3. 当前网络能稳定下载约 200 MB 的文件吗？否 → 国内网络访问默认源速度不稳定，检查点 2 里会给出仓库提供的国内镜像源。

检查点 1：安装 Arduino IDE 并添加 ESP32 板卡索引 URL

目标：让 IDE 能从网络源找到 esp32 平台包。

• 从 arduino.cc 官网下载 Arduino IDE（1.8 以上或 2.x），安装时默认选项即可
• 打开 File → Preferences
• 在 Additional Boards Manager URLs 中粘贴官方索引地址（稳定版）：https://espressif.github.io/arduino-esp32/package_esp32_index.json
• 国内网络改为国内镜像：https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json
• 保存关闭（IDE 2.x 会自动保存）

完成标志：Preferences 窗口中该 URL 原样保留，且能正常关闭窗口。

检查点 2：Boards Manager 安装 esp32 平台包

目标：把工具链、核心库（当前 3.3.11）全部装好。

• Tools → Board → Boards Manager，搜索esp32
• 找到 "ESP32 by Espressif Systems"，点 Install；使用国内镜像源时选版本名带-cn后缀的条目
• 下载约 200 MB，视网速 5 到 10 分钟
• 装完重启 IDE

⚠️ 这一步最容易卡住：进度停在 5% 以下。原因通常是国内网络访问了默认源，先解决网络再回来继续。

完成标志：重启后 Boards Manager 里 esp32 条目旁出现 Installed 标记；Tools → Board 菜单能看到 esp32 系列型号。

补充：Boards Manager 是首选路径。仅当你要手动安装（目前官方仅支持 Windows 手动路径）时，才需要把仓库克隆到开发板目录：

git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32

手动安装的完整步骤见仓库自带文档 docs/en/installing.rst。

检查点 3：选择 ESP32 型号与 COM 端口

目标：让 IDE 知道往哪块板子、哪个口上传。

• Tools → Board 中选择具体型号，如 ESP32 Dev Module
• Tools → Port 中选择刚插入的 COM 端口（macOS/Linux 下是/dev/...）
• 端口没出现时重新插拔 USB，或换一根数据线
• 选择后重启 IDE 一次

完成标志：Tools → Board 列表中能找到你的型号，且 COM 端口下拉框列出设备；拔掉 USB 后端口消失，说明驱动识别正常。

最小验证：用串口输出确认 ESP32 开发环境跑通

把下面 20 行的 WiFi 扫描代码上传，串口监视器设 115200。判断成败看输出，不看界面。

#include <WiFi.h> void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); } void loop() { int n = WiFi.scanNetworks(); if (n == 0) { Serial.println("no networks found"); } else { Serial.printf("found %d networks:\n", n); for (int i = 0; i < n; i++) { Serial.printf("%2d: %s (%d%%)\n", i + 1, WiFi.SSID(i).c_str(), WiFi.RSSI(i)); } } delay(10000); }

预期输出：每 10 秒一组，先是found N networks:，随后 N 行 SSID 和信号强度；附近没有任何 WiFi 时输出no networks found。只要串口出现上面任意一种，环境就搭好了。

ESP32 安装排障：三个高频问题

症状：上传时提示找不到开发板或端口无效最可能原因：COM 端口选错，或 USB 线是纯充电线。 动作：① Tools → Port 确认端口对应你的设备；② 换一根确认能传数据的线；③ 仍失败就按住 BOOT 键再点上传，让开发板进入下载模式。

症状：编译报库文件缺失、路径错误最可能原因：平台包装完没重启 IDE，工具链未生效。 动作：① 重启 Arduino IDE；② 重新选择开发板型号；③ 仍报错则 Boards Manager 卸载后重装 esp32 包。

症状：Boards Manager 下载停在 5% 左右不动最可能原因：国内网络访问默认源速度极慢。 动作：① 回检查点 1 把 URL 换成国内镜像源；② 卸载已装一半的 esp32 包；③ 重新安装，选带-cn后缀的版本。

跑通之后的延伸方向

串口验证通过后，可以先把 libraries/WiFi/examples/WiFiScan/ 里的官方示例完整读一遍，再按需探索仓库文档中的 OTA 无线更新 和 受支持开发板列表。接下来立即做三件事：

1. 把验证代码改成连接你自己的 WiFi，打印获取到的 IP 地址
2. 通读 WiFiScan 示例，确认你已能独立读懂仓库内的代码组织
3. 在 Boards Manager 里记录当前安装的版本号，为日后升级留底

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