1. ESP32开发环境搭建：工欲善其事，必先利其器

做嵌入式开发，第一件事就是把开发环境收拾利索。ESP32 这块芯片我用了好几年，从最早的 ESP32-D0WDQ6 到现在的 S3、C3 系列，开发环境搭建的套路基本没变。今天咱们就把 Arduino IDE 这套环境从头到尾捋一遍。

1.1 为什么选 Arduino IDE？

你可能用过 ESP-IDF，那是乐鑫官方的框架，功能全但门槛高。Arduino IDE 呢？说白了就是「开箱即用」。我刚开始带团队时，新人上手 ESP-IDF 至少得折腾两天，换成 Arduino IDE，两小时就能点灯。

Arduino IDE 对 ESP32 的支持已经很成熟了。底层还是调用 ESP-IDF 的 API，但封装得更友好。你写个 digitalWrite()，背后其实走的是 IDF 的 GPIO 驱动。这对快速验证传感器、做原型开发来说，效率高得多。

对比项	Arduino IDE	ESP-IDF
上手难度	低，有 Arduino 基础就能用	高，需要理解 FreeRTOS 和 CMake
编译速度	较快，适合小项目	较慢，但适合大型工程
库生态	极其丰富，传感器库一搜一大把	官方库为主，第三方库较少
调试能力	串口打印为主	支持 JTAG、GDB 调试
适合场景	原型验证、教学、小批量产品	量产产品、复杂多任务系统

1.2 安装 Arduino IDE

去官网下载就行，地址我就不贴了，搜「Arduino IDE download」第一个就是。目前稳定版是 2.x 系列，比 1.x 好用太多——代码补全、串口监视器、主题切换，体验接近 VS Code。

安装步骤很简单，我快速过一遍：

1. 下载安装包：Windows 选 EXE，macOS 选 DMG，Linux 选 AppImage 或命令行装。
2. 一路默认安装：Windows 用户注意，安装路径别带中文，否则后面编译可能报奇奇怪怪的错。
3. 首次启动：会弹窗提示安装驱动，点同意就行。如果没弹，后面手动装也不麻烦。

1.3 配置 ESP32 板级支持包

Arduino IDE 默认不支持 ESP32，得手动加板级支持包（Board Support Package，简称 BSP）。这一步是核心，配好了才能编译下载。

操作流程：

1. 打开 Arduino IDE，点 文件 → 首选项（Windows 快捷键 Ctrl+逗号）。
2. 在「附加开发板管理器网址」里填入 ESP32 的 JSON 索引地址：
   https://espressif.github.io/arduino-esp32/package_esp32_index.json
3. 点 工具 → 开发板 → 开发板管理器，搜索「ESP32」。
4. 找到「ESP32 by Espressif Systems」，点安装。版本选最新的稳定版就行，我写这本书时是 2.0.14。

安装过程会下载工具链、编译器、核心库，大概 200MB 左右，网速慢的话得等一会儿。你可以去泡杯咖啡。

1.4 驱动安装与开发板选择

驱动这块，不同 ESP32 开发板用的 USB 转串口芯片不一样。市面上最常见的三种：

USB 芯片型号	常见开发板	驱动安装	注意事项
CP2102 (Silicon Labs)	ESP32 DevKitC、NodeMCU-32S	Windows 自动更新，或去 Silicon Labs 官网下载	macOS 和 Linux 通常免驱
CH340/CH341	便宜版 ESP32 开发板、ESP32-DevKitM-1	需要手动安装，搜「CH340 驱动」	Windows 10/11 有时会自动装，但建议手动装最新版
FT232 (FTDI)	老款开发板、官方 ESP-Prog	FTDI 官网下载 VCP 驱动	正品 FT232 价格高，假货多，注意辨别

怎么判断你的板子用哪种芯片？看板子上的 USB 口附近，有个小芯片，上面印着型号。或者插上电脑，在设备管理器里看「端口 (COM 和 LPT)」下面显示什么。

1.5 开发板选择指南

ESP32 系列现在型号很多，初学者容易挑花眼。我按使用场景给你列个表：

型号	核心特点	适合场景	参考价格
ESP32-WROOM-32	双核 240MHz、520KB SRAM、Wi-Fi + BLE	通用数据采集、传感器网关	¥15-25
ESP32-S3	双核 240MHz、512KB SRAM、Wi-Fi + BLE 5.0、支持向量扩展	AI 边缘计算、摄像头、LCD 显示	¥20-35
ESP32-C3	单核 160MHz、400KB SRAM、Wi-Fi + BLE 5.0、RISC-V 架构	低功耗传感器节点、电池供电设备	¥10-18
ESP32-PICO-D4	小封装、内置 Flash、Wi-Fi + BLE	可穿戴设备、空间受限的产品	¥20-30

咱们这门课主要用 ESP32-WROOM-32 和 ESP32-S3 这两款。WROOM-32 是经典款，资料多、社区活跃，适合入门。S3 性能更强，后面做高级项目时会用到。

1.6 第一个程序：点亮板载 LED

环境搭好了，咱们跑个程序验证一下。ESP32 开发板上通常有个板载 LED，接在 GPIO2 上（有些板子是 GPIO1 或 GPIO5，具体看原理图）。

void setup() {
  pinMode(2, OUTPUT);  // 设置 GPIO2 为输出模式
}

void loop() {
  digitalWrite(2, HIGH);  // 点亮 LED
  delay(1000);            // 延时 1 秒
  digitalWrite(2, LOW);   // 熄灭 LED
  delay(1000);            // 延时 1 秒
}

上传步骤：

1. 用 USB 线把开发板连到电脑。
2. 在 Arduino IDE 里选 工具 → 开发板 → ESP32 Dev Module。
3. 选 工具 → 端口，找到你的开发板对应的 COM 口（Windows 是 COMx，Linux 是 /dev/ttyUSB0 或 /dev/ttyACM0，macOS 是 /dev/cu.usbserial-xxxx）。
4. 点上传按钮（右箭头）。
5. 看到「Connecting...」时，按住开发板上的 BOOT 键不放，等开始上传再松手。有些新板子支持自动复位，不需要手动按 BOOT。

如果一切顺利，板载 LED 会以 1 秒间隔闪烁。恭喜，你的 ESP32 开发环境正式跑通了！

1.7 本章知识体系总览

下面这张图把本章的核心内容串起来了，你可以对照着检查自己有没有遗漏：

这张图把咱们这章的内容分成了四大块：IDE 安装、BSP 配置、驱动安装、开发板选择。最后用点灯程序做验证，形成一个完整的闭环。你按这个顺序走一遍，环境就稳了。