1. ESP32 开发环境搭建：工欲善其事，必先利其器
各位同学，咱们正式开始。第一章说白了就是“把枪擦亮”。你想想看，代码写得再漂亮，环境搭不好，连灯都点不亮，那多憋屈。
我个人习惯，拿到一块新开发板，第一件事不是看 datasheet，而是先把 IDE 和工具链跑通。这一步顺了，后面写驱动、调传感器才能心不慌。咱们这一章的目标很明确：装好 Arduino IDE、配好 ESP32 板级支持包、搞定驱动，然后选一块合适的开发板。
1.1 Arduino IDE 安装：最熟悉的陌生人
很多同学觉得 Arduino IDE 太“玩具”，不够专业。我刚开始也这么想，后来在项目里赶工期才发现，Arduino 的生态是真的香——库多、例程多、社区活跃。ESP32 官方也主推 Arduino 框架，所以咱们就用它。
安装步骤很简单，但有几个坑我帮你踩过了：
- 下载版本：去 Arduino 官网（arduino.cc）下载，别去第三方站点。我建议用 1.8.x 系列，稳定。2.0 系列虽然新，但有些老库兼容性偶尔翻车。
- 安装路径：Windows 下别装到 Program Files，容易权限问题。我习惯装到
D:\Arduino或者C:\Arduino。 - 安装过程：一路 Next 就行，记得勾选“安装 USB 驱动”。
工具 → 端口 看看，没识别到板子再装驱动也不迟。
1.2 ESP32 板级支持包配置：让 IDE 认识 ESP32
Arduino IDE 默认不认识 ESP32，得给它“喂”板级支持包（BSP）。这一步其实就两件事：加一个 JSON 网址，然后下载安装。
具体操作：
- 打开 Arduino IDE，点击
文件 → 首选项。 - 在“附加开发板管理器网址”里填入：
https://espressif.github.io/arduino-esp32/package_esp32_index.json - 点击
工具 → 开发板 → 开发板管理器，搜索ESP32。 - 找到
esp32 by Espressif Systems，点击安装。
安装完成后，在 工具 → 开发板 里就能看到一大串 ESP32 型号了。嗯，到这里 IDE 已经认识 ESP32 了。
1.3 驱动安装：让电脑和板子“握手”
驱动这步，说白了就是让电脑的 USB 口能跟 ESP32 的串口芯片通信。ESP32 开发板上常见的串口芯片有两种：
| 串口芯片 | 常见于 | 驱动名称 |
|---|---|---|
| CP2102 | ESP32 DevKitC、NodeMCU-32S | CP210x USB to UART Bridge |
| CH340 | 一些国产 ESP32 开发板 | CH340/CH341 |
怎么看你的板子用哪个？翻一下板子背面，找到那个小芯片，上面印着型号。或者直接插上电脑，去设备管理器看“端口 (COM 和 LPT)”下面有没有黄色感叹号。
驱动安装很简单：去芯片厂商官网下载对应驱动，双击安装就行。Windows 10/11 通常能自动识别，但 CH340 偶尔需要手动装。
1.4 开发板选择：选对板子，少走弯路
市面上 ESP32 开发板五花八门，咱们课程里主要用两种。我帮你对比一下：
| 型号 | 特点 | 适用场景 | 参考价格 |
|---|---|---|---|
| ESP32-DevKitC | 官方标准板，引脚全引出，稳定 | 学习、原型验证 | 30-50 元 |
| NodeMCU-32S | 集成 USB 转串口，面包板友好 | 快速原型、传感器实验 | 25-40 元 |
| ESP32-WROOM-32 | 核心模组，需自己搭底板 | 产品集成、定制开发 | 15-25 元 |
我个人建议初学者用 NodeMCU-32S。原因很简单：它把 USB 转串口、复位电路、LED 指示灯都集成好了，插上线就能用。咱们后面接传感器、调 OLED，它也很方便。
1.5 验证环境：点亮第一盏灯
环境搭没搭好，跑个 Blink 例程就知道了。这是嵌入式界的“Hello World”。
操作步骤：
- 在 Arduino IDE 中，选择
工具 → 开发板 → ESP32 Arduino → NodeMCU-32S（或你对应的板型）。 - 选择
工具 → 端口，选中你板子对应的 COM 口。 - 打开
文件 → 示例 → 01.Basics → Blink。 - 点击上传按钮（右箭头）。
代码很简单，就这几行：
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(1000);
digitalWrite(LED_BUILTIN, LOW);
delay(1000);
}上传成功后，板子上的 LED 应该以 1 秒间隔闪烁。如果没亮，检查一下：
- 端口选对了没？
- 板子型号选对了没？
- 有些板子的 LED 是低电平点亮，代码里要改成
LOW亮。
灯亮了，恭喜你，环境搭建成功！
1.6 知识体系总览
下面这张图帮你理清本章的知识结构：
这张图把咱们这一章的内容串起来了。从中心向外看：先装 IDE，再配 BSP，然后装驱动，最后选板子。每一步都验证通过，才能点亮那盏灯。