
Arduino ESP32 核心库15 分钟完成 ESP32 开发环境搭建与串口验证【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32Arduino 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 IDE1.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 原样保留且能正常关闭窗口。检查点 2Boards 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 ModuleTools → 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 无线更新 和 受支持开发板列表。接下来立即做三件事把验证代码改成连接你自己的 WiFi打印获取到的 IP 地址通读 WiFiScan 示例确认你已能独立读懂仓库内的代码组织在 Boards Manager 里记录当前安装的版本号为日后升级留底【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考