3. 开发环境搭建：工欲善其事，必先利其器
做物联网开发，第一道坎往往不是代码本身，而是环境搭不起来。我见过太多新手卡在驱动装不上、板子认不到、编译报错看不懂这些地方，一卡就是半天。说实话，这些坑我自己早年也都踩过。今天咱们就把 Arduino IDE 的安装、ESP32 支持包配置、串口调试这三件事一次性捋清楚。
本章核心脉络：从零搭建一套能跑 ESP32 的开发环境，包含 IDE 安装、板级支持包下载、驱动调试三步。下面这张图帮你快速建立全局认知。
3.1 Arduino IDE 安装与基础配置
Arduino IDE 是入门物联网开发最友好的工具，没有之一。它把编译、烧录、串口监视都集成在一个窗口里，对新手特别友好。我个人习惯用 2.x 版本，界面更现代，功能也更全。
3.1.1 下载与安装
- 访问官网：打开
arduino.cc/en/software，选择对应操作系统的版本。Windows 用户选 EXE 安装包，macOS 用户选 DMG。 - 安装过程：一路默认选项即可。Windows 下记得勾选「安装 USB 驱动」——这个选项默认是勾上的，别手快取消掉。
- 首次启动：打开后界面是英文的。点
File → Preferences → Language，选简体中文，重启 IDE 就变成中文了。
我的经验：如果你用 Windows，安装路径尽量不要带中文和空格。我之前有个项目就因为路径里有中文，编译死活报错，折腾了半小时才发现是路径问题。
3.1.2 界面速览
装好后别急着写代码，先熟悉几个关键区域：
- 工具栏：验证（编译）、上传、新建、打开、保存、串口监视器。这六个按钮覆盖了 90% 的日常操作。
- 代码编辑区：写代码的地方。支持语法高亮和自动缩进。
- 状态栏：显示当前选择的开发板和串口。很多人编译报错就是因为这里没选对。
- 输出窗口：编译日志和烧录信息都在这里。报错时先看这里，别瞎猜。
3.2 ESP32 开发板支持包安装
Arduino IDE 原生不支持 ESP32，需要额外安装板级支持包。说白了就是告诉 IDE：「我要用 ESP32 这颗芯片，请把它的编译工具链和库准备好。」
3.2.1 添加开发板管理器地址
打开 文件 → 首选项，在「附加开发板管理器网址」里填入以下地址：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json注意：如果你同时用 ESP8266，可以用逗号分隔，把两个地址都加进去。我曾经见过有人把地址拼错了，结果怎么都搜不到 ESP32 的包。
3.2.2 安装 ESP32 包
- 点击
工具 → 开发板 → 开发板管理器。 - 搜索框输入
ESP32，找到由 Espressif Systems 官方发布的包。 - 点击「安装」，版本选最新的稳定版（目前是 2.0.14 或 3.x，看你的需求）。
- 等待下载完成——这个过程可能比较慢，因为要下载工具链和库文件，总共大概 200-300MB。
加速技巧：如果下载太慢，可以配置国内镜像源。在首选项的「附加开发板管理器网址」里，把上面的地址换成 https://mirrors.ustc.edu.cn/arduino/package_esp32_index.json。中科大的镜像，速度能快好几倍。
3.2.3 选择开发板
安装完成后，在 工具 → 开发板 → ESP32 Arduino 下就能看到各种 ESP32 型号了。常用的有：
| 开发板型号 | 适用场景 | 备注 |
|---|---|---|
| ESP32 Dev Module | 通用开发板，如 ESP32-DevKitC | 最常用，兼容性最好 |
| NodeMCU-32S | NodeMCU 系列 ESP32 板 | 国内常见，便宜好用 |
| WEMOS LOLIN32 | LOLIN 系列小板 | 适合电池供电项目 |
| ESP32S3 Dev Module | ESP32-S3 芯片开发板 | 带 USB OTG 和更多 GPIO |
选好板子后，在 工具 菜单里还要确认一下 Flash Size（一般选 4MB）、Partition Scheme（默认即可）、Port（串口号）。
3.3 串口驱动与调试工具
环境搭好了，板子也选了，但插上 USB 后电脑没反应？别慌，大概率是驱动没装。
3.3.1 串口驱动安装
ESP32 开发板常用的 USB 转串口芯片有两种：
| 芯片型号 | 常见于 | 驱动下载 |
|---|---|---|
| CP2102 | 官方 ESP32-DevKitC、部分 NodeMCU | Silicon Labs 官网 |
| CH340 | 国内大部分廉价开发板 | WCH 官网 |
| FT232 | 高端开发板、调试器 | FTDI 官网 |
怎么看你的板子用的是什么芯片？看板子上的 USB 接口附近，一般会印着芯片型号。或者插上电脑，在设备管理器里看「端口 (COM 和 LPT)」下面出现的是什么设备。
避坑指南：我曾经遇到过一块板子，插上后设备管理器里显示「未知设备」。折腾了半天，发现是 USB 线的问题——有些便宜的数据线只能充电，不能传数据。换一根带数据传输功能的线就好了。
3.3.2 验证驱动是否正常
驱动装好后，插上开发板，在设备管理器里应该能看到类似这样的信息：
- Windows：
端口 (COM 和 LPT) → Silicon Labs CP210x USB to UART Bridge (COM3) - macOS：
/dev/cu.SLAB_USBtoUART或/dev/cu.usbserial-xxxx - Linux：
/dev/ttyUSB0或/dev/ttyACM0
记下这个端口号，后面选串口的时候要用。
3.3.3 串口监视器使用
Arduino IDE 自带的串口监视器是调试利器。点击右上角的「串口监视器」图标，或者按 Ctrl+Shift+M 打开。关键设置就两个：
- 波特率：要和代码里
Serial.begin(115200)保持一致。我习惯用 115200，速度快，够用。 - 换行符：一般选「换行」或「两者都选」。如果你发的指令没被正确解析，检查一下这里。
我的习惯：调试时我会同时打开串口监视器和串口绘图仪（工具 → 串口绘图仪）。监视器看文本日志，绘图仪看传感器数值曲线，两个配合起来效率很高。
3.4 验证环境：点亮板载 LED
环境搭好了，跑个经典的 Blink 示例验证一下。这是物联网开发的「Hello World」。
3.4.1 打开示例代码
点击 文件 → 示例 → 01.Basics → Blink。代码会自动打开，内容是这样的：
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(1000);
digitalWrite(LED_BUILTIN, LOW);
delay(1000);
}注意：ESP32 的板载 LED 通常接在 GPIO2 上，但 LED_BUILTIN 这个常量已经帮你定义好了，直接用就行。
3.4.2 编译与烧录
- 确认开发板选的是
ESP32 Dev Module。 - 确认端口选的是你刚才记下的那个串口号。
- 点击「上传」按钮（右箭头图标）。
- 观察输出窗口：编译完成后，会提示
Connecting...，这时候有些开发板需要按住BOOT键再按一下EN键才能进入下载模式。
常见问题：如果上传时一直卡在 Connecting...，试试手动进入下载模式：按住 BOOT 键不放，按一下 EN 键，松开 BOOT 键。如果还不行，检查一下串口驱动和 USB 线。
3.4.3 观察结果
烧录成功后，板载 LED 应该以 1 秒为间隔闪烁。如果没亮，别急，先检查：
- 板子供电正常吗？有些开发板需要外部供电才能点亮 LED。
- 代码里的引脚对不对？有些 ESP32 开发板的板载 LED 接的不是 GPIO2，查一下原理图。
- 是不是烧录成功了？看输出窗口有没有
Hash of data verified之类的提示。
嗯，到这里你的开发环境就算正式搭好了。后面写代码、调传感器、连云端，都基于这套环境。环境稳了，后面的事就顺了。