外观
第一次上手
目标是以最快的速度，不到一个小时，让一块 ESP32 开发板亮灯或联网。先选板，再选一条路径，最后了解几个最常见的坑。
先选一块板
新手不要追最新的芯片，选生态成熟、资料多的：
| 需求 | 推荐 | 说明 |
|---|---|---|
| 通用入门 | ESP32-S3 开发板，如ESP32-S3-DevKitC-1 | 双核、有原生 USB、可选 PSRAM，几乎所有教程都覆盖 |
| 最便宜 | ESP32-C3 开发板，如XIAO ESP32C3 | 单核 RISC-V，体积小，价格低 |
| 做 Matter / Thread / Zigbee | ESP32-C6 开发板，如ESP32-C6-DevKitC-1 | Wi-Fi 6 加 802.15.4 |
| 带屏幕、开箱即用 | M5Stack 系列 | 屏幕、电池、外壳一体 |
| 玩经典教程 | ESP32-DevKitC | 原始 ESP32，资料最多，但没有原生 USB |
三条快速路径
路径 1：Arduino IDE
适合有一点 C / C++ 基础，或者用过 Arduino 的人。
- 在本地电脑安装 Arduino IDE 2.x。
- 在「开发板管理器」中搜索
esp32(由 Espressif Systems 提供)，安装。 - 选择对应的开发板型号和串口。
- 打开示例中的 Blink 或 WiFiScan，点击上传。
路径 2：ESPHome
适合智能家居玩家，不想写代码，只写 YAML 配置。
- 在 Home Assistant 里安装 ESPHome 附加组件，或在电脑上安装 ESPHome 命令行。
- 新建设备，选择芯片，填入 Wi-Fi 信息。
- 第一次通过 USB 烧录，之后可以通过 Wi-Fi 无线更新。
详见ESPHome。
路径 3：MicroPython
适合习惯 Python、想交互式调试的人。
- 在本地电脑下载对应芯片的 MicroPython 固件，用 esptool 或网页烧录工具写入。
- 用 Thonny 等工具连接串口，进入 REPL 实时执行代码。
- 通过
main.py让程序开机自动运行。
详见MicroPython 与烧录工具。
如果你想用官方原生框架，可以看ESP-IDF，学习曲线更陡，但功能最全。
USB 驱动
不少开发板用 USB 转串口芯片：
- CP210x (Silicon Labs) 与 CH340 / CH343 (沁恒)：电脑里看不到串口时，通常是缺驱动。macOS 和 Windows 新版本多数能自动识别，识别不了就去芯片厂商官网下载驱动。
- 使用原生 USB 的芯片 (S2、S3、C3、C6 等) 不需要这类芯片，直接被识别为 USB 串口 / JTAG 设备。
如果插上线没有串口，先换一根能传数据的 USB 线。只能充电的线很常见。
启动模式
ESP32 有两种常见状态：正常运行和下载模式 (烧录固件时使用)。
- 大多数开发板会自动切换，不用手动操作。
- 自动失败时，手动进入下载模式：按住 BOOT 键，同时按一下 RESET (或 EN) 键，再松开 BOOT。
- 原生 USB 的芯片在固件卡死后，也可以用同样的手法进入下载模式，让电脑重新识别设备。
具体的 GPIO 与启动配置 (strapping pins) 因芯片而异，请查对应芯片规格书。
常见的坑
- 3.3V 逻辑：ESP32 的 IO 不耐 5V，直接接 5V 传感器输出可能损坏引脚。
- 供电不足：开启 Wi-Fi 时瞬时电流较大，劣质 USB 线或 USB 口会导致随机重启。
- 容量买错：Flash 和 PSRAM 容量不够，固件放不下，见型号命名与系列。
- 板子不稳定：多半是电源问题，而不是代码。