1. ESP32 开发环境搭建：Arduino IDE 安装、板卡配置与驱动验证

做嵌入式开发这么多年，我始终觉得环境搭建是入门的第一道坎。很多朋友买了 ESP32 开发板，兴冲冲地插上电脑，结果发现设备管理器里啥也没出现——嗯，这种情况我见过太多次了。

这一章，咱们就把环境搭起来。说白了就是三步：装 Arduino IDE、配 ESP32 板卡、搞定驱动。每一步我都会把坑指出来。

1.1 下载与安装 Arduino IDE

Arduino IDE 是官方提供的免费开发工具。我个人习惯从官网下载，别去第三方站点，容易踩雷。

1. 打开官网：访问 arduino.cc/en/software，选择对应你操作系统的版本（Windows / macOS / Linux）。
2. 下载安装包：Windows 用户选 Windows Win 10 and newer, 64 bits 或 MSI installer。我建议用 MSI 版本，安装路径干净，后续好找。
3. 运行安装程序：一路默认选项即可。注意勾选「Install USB driver」——这个很多人会漏掉，后面驱动出问题就麻烦了。
4. 首次启动：安装完成后打开 IDE，界面默认是英文。别急，后面可以改中文。

1.2 配置 ESP32 板卡支持包

Arduino IDE 原生不支持 ESP32，需要手动添加板卡管理器地址。这一步很多人搞不定，其实就两行 URL 的事。

步骤一：添加附加开发板管理器网址

1. 打开 Arduino IDE，点击 文件 → 首选项（或快捷键 Ctrl + ,）。
2. 在「附加开发板管理器网址」输入框中，粘贴以下地址：

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

如果你需要同时支持 ESP8266，可以再加一行（用逗号分隔）：

https://arduino.esp8266.com/stable/package_esp8266com_index.json

3. 点击「确定」保存。

步骤二：安装 ESP32 板卡

1. 点击 工具 → 开发板 → 开发板管理器。
2. 在搜索框输入 ESP32，找到 esp32 by Espressif Systems。
3. 点击「安装」，版本建议选最新的稳定版（我写这章时是 2.0.14）。
4. 等待下载完成——这个过程取决于网速，大概 5~15 分钟。如果卡住，可以试试科学上网。

1.3 安装 USB 转串口驱动

ESP32 开发板通过 USB 转串口芯片与电脑通信。市面上常见的芯片有两种：CP2102 和 CH340。你得先确认自己板子上用的是哪颗。

驱动安装很简单：下载对应系统的驱动包，双击运行，重启电脑即可。Windows 10/11 通常能自动识别 CH340，但 CP2102 有时需要手动装。

1.4 选择开发板与端口

驱动搞定后，回到 Arduino IDE，做两件事：

1. 选择开发板：点击 工具 → 开发板 → ESP32 Arduino，选择你的板型。最常用的是 ESP32 Dev Module，兼容大多数开发板。
2. 选择端口：点击 工具 → 端口，选择刚才在设备管理器里看到的 COM 口。

如果你用的是 ESP32-S3 或 C3 系列，记得选对应的板型，比如 ESP32S3 Dev Module 或 ESP32C3 Dev Module。选错了也能编译，但下载时可能报错。

1.5 验证环境：点亮板载 LED

环境搭没搭好，跑个程序就知道了。ESP32 开发板上通常有一个板载 LED，连接到 GPIO2（大部分型号如此）。咱们写个 Blink 程序验证一下。

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

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

操作步骤：

1. 将代码复制到 Arduino IDE 编辑区。
2. 点击 ✓（验证） 按钮编译。第一次编译会下载工具链，稍等片刻。
3. 编译通过后，点击 →（上传） 按钮。
4. 观察开发板：如果 LED 以 1 秒间隔闪烁，恭喜你——环境搭建成功！

1.6 本章知识结构

下面这张图把整个环境搭建的流程串起来了。你跟着箭头走，基本不会迷路。

1.7 常见问题与避坑指南

• 下载板卡包超时：国内网络有时连不上 GitHub。可以尝试用手机热点，或者换个时间段再试。实在不行，去乐鑫官网下载离线包手动安装。
• 编译时提示找不到 esp32 文件夹：说明板卡没装成功。重新打开开发板管理器，确认 ESP32 条目显示「INSTALLED」。
• 上传时一直显示 Connecting...：按住开发板上的 BOOT 键不放，再点上传。看到进度条开始走动后再松手。
• 串口监视器乱码：检查波特率是否设置正确。ESP32 默认串口波特率是 115200，在工具菜单里调一下就好。

环境搭好之后，后面的 GPIO 控制和继电器驱动才能跑起来。别急，先把这一步走稳了，后面就顺了。