2、开发环境搭建：ESP-IDF与Arduino IDE的选择。VS Code + PlatformIO 配置。串口驱动与第一个Blink程序。
好，咱们正式开始动手了。这一章聊开发环境。
很多新手上来就卡在环境搭建上，装了一堆软件，最后连个灯都点不亮。我当年也踩过这个坑，折腾了两天才发现是串口驱动没装对。所以这一章，我带你一次性搞定。
2.1 ESP-IDF 还是 Arduino IDE？我的选择
先说结论：做产品，我选 ESP-IDF；做原型验证，Arduino IDE 更快。
ESP-IDF 是乐鑫官方的框架，功能全、性能强。你想用 Wi-Fi、蓝牙、OTA 升级、低功耗管理，它都支持。但缺点也很明显——学习曲线陡。我第一次用 ESP-IDF 时，光是理解它的构建系统就花了一下午。
Arduino IDE 呢？简单粗暴。写个 Blink 只要几行代码，点一下上传就完事。但它的底层封装太厚了，出了问题你很难定位。我在项目中遇到过，Arduino 下跑得好好的代码，换成 ESP-IDF 就死机，最后发现是中断优先级没配好。
所以我的建议是：如果你打算长期做嵌入式开发，直接上 ESP-IDF。 如果你只是临时验证个想法，Arduino IDE 也够用。但咱们这个课程，我会以 ESP-IDF 为主，因为它是真正能上生产环境的方案。
核心结论：
- ESP-IDF：适合产品级开发，功能完整，但配置复杂
- Arduino IDE：适合快速原型，上手快，但深度不够
- 我的选择：课程用 ESP-IDF，但会穿插 Arduino 对比
2.2 VS Code + PlatformIO：最佳组合
说实话，我很少直接用 ESP-IDF 的命令行工具。太累了。每次都要敲一堆命令，还容易拼错。后来我发现了 VS Code + PlatformIO，这组合简直是为嵌入式开发量身定做的。
PlatformIO 是一个插件，它帮你管理了编译器、调试器、库依赖。你只需要写代码，剩下的它帮你搞定。我现在的所有项目，包括给客户做的量产固件，都是用这套环境。
安装步骤（精简版）
- 下载安装 VS Code（官网直接下，别去第三方）
- 打开 VS Code，点左侧扩展图标，搜索 "PlatformIO IDE"
- 安装，重启 VS Code
- 创建新项目：选择 Board 为 "Espressif ESP32 Dev Module"
- Framework 选 "Espressif IoT Development Framework (ESP-IDF)"
嗯，这里要注意：第一次创建项目时，PlatformIO 会自动下载 ESP-IDF 工具链。这个过程比较慢，大概 10-20 分钟。我建议你泡杯咖啡，或者去刷会儿手机。别中途关掉，否则下次还得重来。
小技巧：如果你在公司网络环境下，可能会遇到下载失败。可以手动设置代理，或者直接去乐鑫官网下载 ESP-IDF 离线包，然后让 PlatformIO 指向本地路径。
2.3 串口驱动：最容易翻车的地方
为什么单独说串口驱动？因为我在项目中遇到过太多次了——板子插上电脑，设备管理器里死活不显示 COM 口。新手第一反应是板子坏了，其实 90% 是驱动没装。
ESP32 开发板用的串口芯片主要有两种：
| 串口芯片 | 常见型号 | 驱动名称 |
|---|---|---|
| CP2102 | 安信可、部分官方板 | CP210x 驱动 |
| CH340 | 很多廉价开发板 | CH340 驱动 |
怎么判断你用的是哪种？看板子上的芯片型号。一般是个小方片，上面印着 "CP2102" 或 "CH340"。如果你看不清楚，直接两个驱动都装上，反正不冲突。
避坑指南：我曾经遇到过 CH340 驱动在 Windows 10 上装不上，最后发现是系统自动更新的驱动版本太旧。解决办法：去官方下载最新版，手动安装，不要用 Windows 自动搜索。
2.4 第一个程序：Blink
好了，环境搭好了，驱动装上了。咱们来点亮第一个灯。这是嵌入式界的 "Hello World"。
在 PlatformIO 中，打开 src/main.c，输入以下代码：
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"
#define BLINK_GPIO 2 // 大多数 ESP32 开发板的板载 LED 在 GPIO2
void app_main(void)
{
gpio_reset_pin(BLINK_GPIO);
gpio_set_direction(BLINK_GPIO, GPIO_MODE_OUTPUT);
while (1) {
gpio_set_level(BLINK_GPIO, 1);
vTaskDelay(1000 / portTICK_PERIOD_MS);
gpio_set_level(BLINK_GPIO, 0);
vTaskDelay(1000 / portTICK_PERIOD_MS);
}
}
代码很简单，但有几个点我想强调一下：
gpio_reset_pin：先把引脚复位到默认状态，避免之前配置的影响。我刚开始写 ESP-IDF 时经常漏掉这步，结果灯死活不亮。vTaskDelay：这是 FreeRTOS 的延时函数，单位是 tick。用portTICK_PERIOD_MS把毫秒转成 tick，这是标准写法。GPIO2：不是所有板子都用这个引脚。有些板子用 GPIO0 或 GPIO5。如果你发现灯不亮，先查一下原理图。
写完后，点 VS Code 底部状态栏的 "→" 箭头（上传按钮）。PlatformIO 会自动编译并烧录到 ESP32。如果一切顺利，你会看到板子上的 LED 开始以 1 秒间隔闪烁。
如果灯没亮，检查这三步：
- 串口驱动装了吗？设备管理器里有没有 COM 口？
- 板子选对了吗？是不是 "Espressif ESP32 Dev Module"？
- GPIO 引脚对吗？有些板子的 LED 不在 GPIO2。
2.5 小结
这一章我们搞定了三件事：
- 理解了 ESP-IDF 和 Arduino IDE 的适用场景
- 搭建了 VS Code + PlatformIO 的开发环境
- 装好了串口驱动，跑通了第一个 Blink 程序
说实话，环境搭建是最枯燥的部分，但也是最重要的基础。后面咱们要写的代码越来越复杂，如果环境没弄好，排查问题会非常痛苦。所以，花点时间把这一步走稳，后面就顺畅了。
下一章，咱们开始真正接触 ESP-IDF 的工程结构，看看一个完整的固件项目到底长什么样。