📚 课程目录第1章 ESP32开发环境搭建

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

做嵌入式开发，第一关永远是环境搭建。很多人觉得这事简单，不就是装个软件嘛。但我见过太多新手卡在这一步——板子连不上、驱动装不上、编译报错一堆。说白了，环境没搭好，后面全是坑。

这一章，我就带你一步步把 ESP32 的开发环境整利索。跟着我的节奏来，半小时内你就能跑起第一个程序。

1.1 为什么选 Arduino IDE？

你可能听说过 ESP-IDF，那是乐鑫官方的开发框架，功能强大但门槛高。对于快速验证想法、做原型开发，我个人更推荐 Arduino IDE。

上手快：装好就能写，不用折腾 Makefile 和 CMake
生态好：成千上万的库，Wi-Fi、HTTP、传感器，一行 #include 搞定
调试方便：串口监视器直接看输出，不用额外工具

我的习惯：项目初期用 Arduino IDE 快速验证，后期需要性能优化或复杂多任务时再切到 ESP-IDF。两条腿走路，不耽误事。

1.2 Arduino IDE 安装

去官网下载对应你操作系统的版本。Windows 用户选 Windows Installer，macOS 用户选 macOS 版。Linux 用户？嗯，你肯定知道怎么用命令行解压。

双击安装包，一路 Next
安装路径建议用默认，别放中文目录
安装完成后，桌面会出现 Arduino 图标

注意：Windows 用户安装时，如果弹出「设备驱动程序安装」的提示，一定要点「安装」。这是后面识别开发板的关键。我曾经帮一个学员远程调试，折腾了半小时才发现他安装时跳过了驱动。

1.3 ESP32 板级支持包配置

Arduino IDE 默认不支持 ESP32，需要手动添加板级支持包。说白了，就是告诉 IDE：「嘿，我要写 ESP32 的代码了，把它的编译工具链给我准备好」。

操作步骤：

打开 Arduino IDE，点击 文件 → 首选项
在「附加开发板管理器网址」里填入：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
点击 工具 → 开发板 → 开发板管理器
搜索 ESP32，找到由 Espressif Systems 提供的包，点击安装

安装过程会下载约 500MB 的文件，包括编译器、工具链和库。网速慢的话，泡杯咖啡等一等。

关键点：如果安装失败，通常是网络问题。可以尝试更换 DNS 或使用手机热点。我遇到过几次 GitHub 被墙的情况，换个网络环境就好了。

1.4 驱动安装与开发板选择

ESP32 开发板通常通过 USB 转串口芯片与电脑通信。常见的芯片有两种：

芯片型号	常见开发板	驱动下载
CP2102	ESP32-DevKitC、NodeMCU-32S	Silicon Labs 官网
CH340	ESP32 廉价版、ESP32-WROOM-32	WCH 官网

怎么判断你手上的板子用哪种芯片？看板子上的 USB 接口附近，一般会印着芯片型号。或者插上电脑，在设备管理器里看端口信息。

驱动装好后，插上开发板，设备管理器里会出现对应的 COM 口（Windows）或 /dev/cu.usbserial-xxx（macOS）。

然后回到 Arduino IDE，选择开发板：

工具 → 开发板 → ESP32 Arduino → ESP32 Dev Module
工具 → 端口 → 选择你刚才看到的 COM 口

避坑指南：我曾经用一块 ESP32-S3 的板子，选了「ESP32 Dev Module」死活编译不过。后来发现 S3 要选「ESP32S3 Dev Module」。不同芯片型号要选对应的板型，别偷懒。

1.5 验证环境：点亮你的第一个程序

环境搭好了，来跑个经典的 Blink 程序验证一下。

void setup() {
  pinMode(2, OUTPUT);  // ESP32 板载 LED 通常接 GPIO2
}

void loop() {
  digitalWrite(2, HIGH);
  delay(1000);
  digitalWrite(2, LOW);
  delay(1000);
}

点击上传按钮（右箭头），等几秒钟，如果板子上的 LED 开始一秒一闪，恭喜你——环境搭建成功！

常见问题：上传时如果报错 A fatal error occurred: Failed to connect to ESP32，通常是以下原因：
- 按住板子上的 BOOT 键再点上传
- 检查端口是否选对
- 换一根 USB 数据线（有些线只能充电不能传数据）

1.6 本章知识体系

下面这张图帮你理清整个环境搭建的脉络：

这张图把整个流程串起来了。从安装 IDE 开始，到配置板级支持包、装驱动、选板型，最后用 Blink 验证。每一步都有坑，但按这个顺序走，基本不会出大问题。