15分钟给ESP32跑通第一个程序开发板安装与程序上传完整指南【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32你刚花20元买到一块ESP32开发板打开Arduino IDE却在工具→开发板菜单里找不到ESP32的踪影。别急用arduino-esp32这个开源项目——它正是ESP32芯片在Arduino IDE中的官方开发板支持核心负责让ESP32出现在开发板菜单里并把你的代码编译、上传到板子上——整个过程大约15分钟就能跑通。为什么值得花15分钟装好ESP32开发环境装一次环境之后写的所有Arduino风格代码都能直接烧录到ESP32不用每次重新配置。ESP32是一块自带2.4GHz WiFi和蓝牙的芯片加一块开发板总成本在20~45元之间你就能做出能联网、能传数据、能低功耗休眠的硬件。相比树莓派动辄200元以上的投入这个成本更接近坏了也不心疼的量级。arduino-esp32 官方稳定版已支持 8 款芯片ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-H2、ESP32-P4、ESP32-S2、ESP32-S3全部在 docs/en/getting_started.rst 的支持列表中标注为 Stable。你不需要为不同芯片装不同的环境同一个核心通吃。仓库里还内置了 44 个官方库WiFi、BLE、SPI、I2C、文件系统、OTA 升级各管一摊目录在 libraries/。光 ESP32 基础示例库就有 60 多个 .ino 示例从 GPIO 点到深度睡眠打开文件菜单就能找到。动手之前准备清单四样东西备齐后面就不会卡壳。准备项要求说明Arduino IDE1.8 及以上从 arduino.cc 官网下载1.6.4 以上才支持第三方开发板包ESP32 开发板ESP32-DevKitC 或 ESP32-S3 DevKit 均可对应仓库中 variants/ 里的任一板型定义USB 数据线必须是数据线插上去不出现 COM 口九成是线只供电不传数据板管理器网址稳定版 index 地址下文直接给你粘贴即可以最常见的 ESP32-DevKitC 为例板上的接口位置可以参考这张官方引脚图快速安装步骤给Arduino IDE添加ESP32开发板支持安装分四小步全程在 IDE 界面内完成不用敲任何命令。打开 Arduino IDE进入文件→首选项在附加开发板管理器网址一栏粘贴下面这个地址多个网址用英文逗号分隔https://espressif.github.io/arduino-esp32/package_esp32_index.json这一行是 ESP32 官方发布包的索引地址IDE 靠它找到工具链和库文件的位置。国内网络如果下载缓慢官方在 docs/en/installing.rst 的 Installing 章节里提供了 Jihulab 镜像地址替换粘贴即可。保存设置后打开工具→开发板→开发板管理器在搜索框输入esp32。找到条目并点击安装。首次安装会下载完整的 ESP32 工具链编译器和驱动都在里面包体不小家庭宽带下留 5~15 分钟等进度条走完。安装完成后重启 IDE在工具→开发板里选择你的板子例如 ESP32 选 ESP32 Dev ModuleESP32-S3 选 ESP32S3 Dev Module。开发板菜单里出现 ESP32说明环境装好了。接下来把开发板插到电脑 USB 口在工具→端口确认出现了 COM 口macOS 上形如 /dev/cu.usbserial-xxx。第一个程序上传一个GPIO点灯端口出现之后新建一个草图文件→新建把默认代码清空换成下面这几行void setup() { pinMode(2, OUTPUT); Serial.begin(115200); } void loop() { digitalWrite(2, HIGH); Serial.println(LED on); delay(1000); digitalWrite(2, LOW); Serial.println(LED off); delay(1000); }这段代码让 GPIO2 上的板载 LED 每秒翻转一次电平同时在串口每 1000ms 打印一行状态——点灯和串口输出两个最常用的 ESP32 功能一次就练到了。ESP32-DevKitC 板载的蓝色 LED 就接在 GPIO2 上。然后点工具栏的上传。IDE 会先编译首次编译要下载工具链组件稍慢再进入下载模式把固件写入芯片。如果进度条停在等待阶段不动按住开发板上的 BOOT 键几秒再松开手动进下载模式即可。效果验证三个信号确认上传成功成功的标志有 3 个逐个对照看灯GPIO2 的蓝色 LED 亮 1 秒、灭 1 秒周期 2 秒规律闪烁。看串口打开串口监视器把波特率选 115200能看到LED on和LED off交替滚动。看编译日志上传完成后日志末尾会显示 Sketch uses X bytes 和 Flash 使用率说明固件确实写进了芯片。三个都满足你的 ESP32 开发环境就算正式落地了。既然已经能点亮 LED顺手验证一下联网能力。新建草图先加入两行#include WiFi.h // WiFi.begin(你的WiFi名, 你的WiFi密码);更省事的做法是直接打开现成示例文件→示例→ESP32→WiFi→WiFiClient按 README 填入你的 WiFi 名称和密码后上传串口监视器里能打印出连接成功和拿到的 IP 地址。完整代码见 libraries/WiFi/examples/WiFiClient/WiFiClient.ino。连上以后这块板子就从点灯玩具升级成了能收发网络数据的节点后面接传感器、传数据都建立在这一步之上。避坑指南上传失败的常见原因与解法遇到卡壳先查这张表覆盖 90% 的新手问题。现象可能原因解法开发板菜单里没有 ESP32板管理器网址没填或没保存重新粘贴 index 地址确认点过确定插板后端口列表是空的数据线只供电换一根数据线Windows 首次使用还要装 CP2102/CH340 驱动上传卡在 Connecting...没进入下载模式按住 BOOT 键等进度条出现后松开再检查串口是否选对串口监视器显示乱码波特率不匹配监视器波特率改成 115200和代码里Serial.begin一致工具链下载反复失败海外资源速度不稳定换官方 Jihulab 镜像源或换网络时段重试板子反复重启、无法编译通过选错开发板型号回工具→开发板核对芯片系列C3 和原生 ESP32 不通用进阶方向从点灯走向小项目环境搭好之后三条现成的进阶路线都能直接打开仓库里的示例照做低功耗电池供电打开 libraries/ESP32/examples/DeepSleep/TimerWakeUp/TimerWakeUp.ino示例设置 5 秒定时器唤醒并用RTC_DATA_ATTR变量在重启间累计开机次数改个参数就能做电池传感器。WiFi 数据上报在 WiFiClient 跑通的基础上用 libraries/HTTPClient/ 或 libraries/WebServer/ 做云端上传和本地 Web 配置页。OTA 无线升级libraries/ArduinoOTA/ 提供示例改完代码不用拔线刷板。更多芯片的板级定义引脚映射在 boards.txt 和 variants/ 目录里换板子前先在这里确认你的板型是否已被收录。到这里你手里已经有一个能编译、能上传、能联网的 ESP32 开发环境。接下来挑一个想解决的问题——监测温湿度、做个小服务器、或者玩 BLE——打开对应的示例库改几行参数15 分钟后的下一个 15 分钟就可以留给你的第一个真正项目了。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/16 19:33:30 · 阅读 1.2k 15分钟给ESP32跑通第一个程序：开发板安装与程序上传完整指南
15分钟给ESP32跑通第一个程序开发板安装与程序上传完整指南【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32你刚花20元买到一块ESP32开发板打开Arduino IDE却在工具→开发板菜单里找不到ESP32的踪影。别急用arduino-esp32这个开源项目——它正是ESP32芯片在Arduino IDE中的官方开发板支持核心负责让ESP32出现在开发板菜单里并把你的代码编译、上传到板子上——整个过程大约15分钟就能跑通。为什么值得花15分钟装好ESP32开发环境装一次环境之后写的所有Arduino风格代码都能直接烧录到ESP32不用每次重新配置。ESP32是一块自带2.4GHz WiFi和蓝牙的芯片加一块开发板总成本在20~45元之间你就能做出能联网、能传数据、能低功耗休眠的硬件。相比树莓派动辄200元以上的投入这个成本更接近坏了也不心疼的量级。arduino-esp32 官方稳定版已支持 8 款芯片ESP32、ESP32-C3、ESP32-C5、ESP32-C6、ESP32-H2、ESP32-P4、ESP32-S2、ESP32-S3全部在 docs/en/getting_started.rst 的支持列表中标注为 Stable。你不需要为不同芯片装不同的环境同一个核心通吃。仓库里还内置了 44 个官方库WiFi、BLE、SPI、I2C、文件系统、OTA 升级各管一摊目录在 libraries/。光 ESP32 基础示例库就有 60 多个 .ino 示例从 GPIO 点到深度睡眠打开文件菜单就能找到。动手之前准备清单四样东西备齐后面就不会卡壳。准备项要求说明Arduino IDE1.8 及以上从 arduino.cc 官网下载1.6.4 以上才支持第三方开发板包ESP32 开发板ESP32-DevKitC 或 ESP32-S3 DevKit 均可对应仓库中 variants/ 里的任一板型定义USB 数据线必须是数据线插上去不出现 COM 口九成是线只供电不传数据板管理器网址稳定版 index 地址下文直接给你粘贴即可以最常见的 ESP32-DevKitC 为例板上的接口位置可以参考这张官方引脚图快速安装步骤给Arduino IDE添加ESP32开发板支持安装分四小步全程在 IDE 界面内完成不用敲任何命令。打开 Arduino IDE进入文件→首选项在附加开发板管理器网址一栏粘贴下面这个地址多个网址用英文逗号分隔https://espressif.github.io/arduino-esp32/package_esp32_index.json这一行是 ESP32 官方发布包的索引地址IDE 靠它找到工具链和库文件的位置。国内网络如果下载缓慢官方在 docs/en/installing.rst 的 Installing 章节里提供了 Jihulab 镜像地址替换粘贴即可。保存设置后打开工具→开发板→开发板管理器在搜索框输入esp32。找到条目并点击安装。首次安装会下载完整的 ESP32 工具链编译器和驱动都在里面包体不小家庭宽带下留 5~15 分钟等进度条走完。安装完成后重启 IDE在工具→开发板里选择你的板子例如 ESP32 选 ESP32 Dev ModuleESP32-S3 选 ESP32S3 Dev Module。开发板菜单里出现 ESP32说明环境装好了。接下来把开发板插到电脑 USB 口在工具→端口确认出现了 COM 口macOS 上形如 /dev/cu.usbserial-xxx。第一个程序上传一个GPIO点灯端口出现之后新建一个草图文件→新建把默认代码清空换成下面这几行void setup() { pinMode(2, OUTPUT); Serial.begin(115200); } void loop() { digitalWrite(2, HIGH); Serial.println(LED on); delay(1000); digitalWrite(2, LOW); Serial.println(LED off); delay(1000); }这段代码让 GPIO2 上的板载 LED 每秒翻转一次电平同时在串口每 1000ms 打印一行状态——点灯和串口输出两个最常用的 ESP32 功能一次就练到了。ESP32-DevKitC 板载的蓝色 LED 就接在 GPIO2 上。然后点工具栏的上传。IDE 会先编译首次编译要下载工具链组件稍慢再进入下载模式把固件写入芯片。如果进度条停在等待阶段不动按住开发板上的 BOOT 键几秒再松开手动进下载模式即可。效果验证三个信号确认上传成功成功的标志有 3 个逐个对照看灯GPIO2 的蓝色 LED 亮 1 秒、灭 1 秒周期 2 秒规律闪烁。看串口打开串口监视器把波特率选 115200能看到LED on和LED off交替滚动。看编译日志上传完成后日志末尾会显示 Sketch uses X bytes 和 Flash 使用率说明固件确实写进了芯片。三个都满足你的 ESP32 开发环境就算正式落地了。既然已经能点亮 LED顺手验证一下联网能力。新建草图先加入两行#include WiFi.h // WiFi.begin(你的WiFi名, 你的WiFi密码);更省事的做法是直接打开现成示例文件→示例→ESP32→WiFi→WiFiClient按 README 填入你的 WiFi 名称和密码后上传串口监视器里能打印出连接成功和拿到的 IP 地址。完整代码见 libraries/WiFi/examples/WiFiClient/WiFiClient.ino。连上以后这块板子就从点灯玩具升级成了能收发网络数据的节点后面接传感器、传数据都建立在这一步之上。避坑指南上传失败的常见原因与解法遇到卡壳先查这张表覆盖 90% 的新手问题。现象可能原因解法开发板菜单里没有 ESP32板管理器网址没填或没保存重新粘贴 index 地址确认点过确定插板后端口列表是空的数据线只供电换一根数据线Windows 首次使用还要装 CP2102/CH340 驱动上传卡在 Connecting...没进入下载模式按住 BOOT 键等进度条出现后松开再检查串口是否选对串口监视器显示乱码波特率不匹配监视器波特率改成 115200和代码里Serial.begin一致工具链下载反复失败海外资源速度不稳定换官方 Jihulab 镜像源或换网络时段重试板子反复重启、无法编译通过选错开发板型号回工具→开发板核对芯片系列C3 和原生 ESP32 不通用进阶方向从点灯走向小项目环境搭好之后三条现成的进阶路线都能直接打开仓库里的示例照做低功耗电池供电打开 libraries/ESP32/examples/DeepSleep/TimerWakeUp/TimerWakeUp.ino示例设置 5 秒定时器唤醒并用RTC_DATA_ATTR变量在重启间累计开机次数改个参数就能做电池传感器。WiFi 数据上报在 WiFiClient 跑通的基础上用 libraries/HTTPClient/ 或 libraries/WebServer/ 做云端上传和本地 Web 配置页。OTA 无线升级libraries/ArduinoOTA/ 提供示例改完代码不用拔线刷板。更多芯片的板级定义引脚映射在 boards.txt 和 variants/ 目录里换板子前先在这里确认你的板型是否已被收录。到这里你手里已经有一个能编译、能上传、能联网的 ESP32 开发环境。接下来挑一个想解决的问题——监测温湿度、做个小服务器、或者玩 BLE——打开对应的示例库改几行参数15 分钟后的下一个 15 分钟就可以留给你的第一个真正项目了。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考