ESP32 Arduino Core 完整指南10 分钟配好开发环境并跑通 Web 服务器【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32arduino-esp32 是 ESP32 系列芯片的官方 Arduino 核心用你熟悉的 Arduino IDE 语法就能给 ESP32、ESP32-S2/S3、ESP32-C3/C6 写代码、编译并上传固件WiFi、BLE、I2C、SPI、文件系统这些驱动全部由板级包一次性装好。做 IoT 原型开发这是绕不开的地基。适合看这篇文章的人手头有 ESP32 板子但 Arduino IDE 还没配好或者配到一半报错的想一次性从找不到板子走到浏览器能打开板子页面的可以跳过的情况已经装好 ESP32 核心、只需要查某个 API 用法的直接看文末的资源索引表板级包到底装了什么东西装包之前先把两个概念搞清楚后面排错时才看得懂报错。板级支持包芯片的系统 驱动生活类比新手机连电脑光有 ROM 不够还得装厂商驱动包电脑才认得它。板级包就是 ESP32 的驱动包。一句话定义一套编译器工具链 核心代码 内置库让 Arduino IDE 把你的 .ino 翻译成 ESP32 能烧写的固件。为什么重要后面选板子、出串口、编译 WiFi 库全靠它。源码本体在 cores/esp32/随包附带的库在 libraries/。variant每块板的引脚字典生活类比同一个词在不同方言里写法不同variant 文件就是每块板子的引脚方言字典。一句话定义把LED_BUILTIN、SDA、SCL这类逻辑名映射成具体板子物理引脚号的一组定义。为什么重要这是同一份 sketch 换块板子还能原样编译的原因。标准 Dev Module 的引脚定义在 variants/esp32/pins_arduino.h整个 variants/ 目录有 300 多个子目录对应各款开发板。接硬件前对照官方引脚图看一遍哪些脚能做 ADC、哪些只能输入、内置 LED 在哪根脚上都标在图上。从零到上传第一个程序的完整流程贴地址装包打开文件 → 首选项macOS 在顶部菜单 Arduino → 设置找到最下方的Additional Boards Manager URLs把下面这行粘进去点 OKhttps://espressif.github.io/arduino-esp32/package_esp32_index.json成功标志重新打开首选项地址仍然留在那个输入框里。板管理器里装核心进入工具 → 开发板 → 板管理器搜索框输入esp32找到 Espressif Systems 发布的esp32条目点Install。成功标志进度条走完按钮变成 Installed没有红色报错。整包有好几百 MB慢网可能要十几分钟耐心等它跑完。选板子、选端口、上传 Blink用数据线把板子插到电脑。工具 → 开发板 → ESP32 Dev Module按你的板子型号选对应的工具 → 端口里选新出现的串口。打开文件 → 示例 → 01.Basics → Blink点上传。成功标志板载 LED 开始闪烁串口监视器波特率设 115200里滚出几行字最后带Hello world!。如果 LED 在闪但监视器一片空白去避坑地图看第二条。如果你的板子不在下拉列表里先搜 variants/ 下的目录名——能对上说明官方支持选引脚最接近的型号即可。避坑地图四种失败及修复动作按出现频率从高到低排出问题照这个顺序查。端口列表里找不到板子或上传必失败症状端口列表是空的或一上传就报端口打不开、需要复位根因USB 线只支持充电不支持传数据或板子没进下载模式修复换一根数据线按一下BOOT键再按一下RESET键同时松开后重新上传串口监视器没有任何输出症状程序明显在跑LED 在闪监视器却一片空白根因监视器波特率和代码不一致或代码里根本没初始化串口修复监视器选 115200确认setup()第一行有Serial.begin(115200);板管理器搜不到 esp32症状搜索结果为空或只出现第三方同名条目根因板管理器 URL 没添加或地址打错了一个字符修复回首选项检查那个输入框注意改完设置要重启 IDE 再搜包下载中断安装卡住症状安装进度条卡死或中途弹错根因下载被网络切断staging 缓存里留了半截包修复关闭 IDE清空 staging 缓存目录重开再装。目录Windows 是C:\Users\用户名\AppData\Local\Arduino15\staging\packagesmacOS 是~/Library/Arduino15/staging/packagesLinux 是~/.arduino15/staging/packages一个能跑通的最小项目手机能打开的 Web 服务器只说做什么、结果是什么。板子以 WiFi 站模式STA就是你手机连路由器那种模式接入家里路由器局域网内任何设备用浏览器直接通过 IP 访问它。第一步新建 sketch先粘声明部分#include WiFi.h #include WebServer.h const char* ssid 你的WiFi名; const char* psk 你的WiFi密码; WebServer server(80);再粘主逻辑setup()最后一行会把板子的 IP 打到串口监视器void setup() { Serial.begin(115200); WiFi.begin(ssid, psk); while (WiFi.status() ! WL_CONNECTED) delay(500); server.on(/, [](){ server.send(200, text/plain, hello from esp32!); }); server.begin(); Serial.println(WiFi.localIP()); }void loop() { server.handleClient(); }第二步把开头的两个变量换成你路由器的 SSID 和密码选对板子和端口上传。第三步从串口监视器抄下 IP形如192.168.x.x在手机或电脑浏览器地址栏输入回车。结果页面显示hello from esp32!这串字就是代码里server.send(...)发出的响应。后面做控制面板、传感器页面、OTA 更新入口都是在这个骨架上加东西可对照 libraries/WebServer/examples/HelloServer/ 里的现成写法。资源索引下一步去哪找你想做什么去哪找安装、更新核心查支持哪些板docs/en/installing.rst、boards.txt点第一个 LED、串口基础docs/en/tutorials/blink.rst查某块板子的引脚定义variants/一板一目录WiFi 连接、热点AP示例libraries/WiFi/examples/WiFiClientBasic、WiFiAccessPointWeb 服务器、页面、文件上传libraries/WebServer/examples/BLE 通信与周边外设libraries/BLE/、docs/en/api/ble.rst本地文件系统LittleFS / SPIFFSlibraries/LittleFS/、libraries/SPIFFS/无线固件更新 OTAlibraries/ArduinoOTA/深睡、定时器、I2C/SPI/ADC 等 APIdocs/en/api/每类外设一篇板子没反应、没输出、装不上docs/en/troubleshooting.rst看官方功能如何验证tests/validation/到这里主线就走完了环境装好、Blink 点亮、板子被浏览器访问到。接下来做什么项目按上表挑库、照它的 examples 改比翻理论文档快得多。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
