五步点亮第一盏灯
- 买一块开发板：入门首选 ESP32 DevKit（约 30 元），需要 USB 或更多性能再看 ESP32-S3，选型对比见「开发板选型」
- 装 Arduino IDE：到 Arduino 官网下载安装，添加乐鑫开发板源（国内建议用镜像源），详见「Arduino IDE 安装」
- 插板装驱动：数据线连接开发板，装好 CP210x 或 CH340 串口驱动，Tools → Port 里能选中端口即就绪
- 烧录 Blink 例程：Tools → Board 选 ESP32 Dev Module，打开 File → Examples → 01.Basics → Blink，点上传
- 看板载 LED 闪烁：烧录完成后按一下 RST 键，LED 开始一秒一闪就成功了
全程约 30 分钟，不焊任何东西，一根 USB 数据线即可完成。
推荐阅读顺序
本项目共 9 个内容页，按学习曲线排列：
| 阶段 | 页面 | 你将学会 |
|---|---|---|
| 入门 | 认识 ESP32 | 芯片家族与能力边界 |
| 开发板选型 | 挑到适合自己的板子 | |
| 上手 | 开发环境搭建 | Arduino 与 ESP-IDF 双路线总览 |
| Arduino IDE 安装 | 新手推荐路线的完整安装 | |
| ESP-IDF 安装 | 进阶官方工具链 | |
| 第一个程序 | Blink 与 hello_world，跑通烧录 | |
| 进阶 | 基础外设 | GPIO、PWM 调光、ADC 读模拟量 |
| WiFi 联网实战 | 联网与 HTTP 请求，IoT 的起点 | |
| 蓝牙 BLE 实战 | 扫描 BLE 设备与广播数据 |
遇到问题随时查最后的「常见问题与故障排查」，串口不识别、烧录失败、连不上 WiFi 等高频故障都在里面。
路线建议
- 只想快速做东西：Arduino 路线，会点亮 LED 后直接跳「基础外设」和「WiFi 联网实战」
- 想吃透 ESP32、奔着产品开发去：Arduino 跑通流程后转 ESP-IDF 路线，官方例程与 FreeRTOS 生态更完整
- 做物联网小项目：外设 + WiFi 两页学完，就具备传感器上网上报数据的全部基础