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

做嵌入式开发，环境搭建是第一道坎。很多人一上来就急着写代码，结果编译报错、板子连不上，折腾半天才发现是驱动没装好。我刚开始玩 ESP32 时也踩过这个坑——插上开发板，电脑一点反应都没有，还以为板子烧了。后来才发现，就是少装了一个 USB 转串口驱动。

这一章，咱们就把 Arduino IDE、ESP32 板级支持包、驱动安装这些基础工作一次性搞定。你跟着我的步骤走，半小时内就能让板子跑起来。

1.1 为什么选 Arduino IDE？

你可能听说过 ESP-IDF、PlatformIO、MicroPython 这些开发方式。没错，它们各有优势。但作为入门，我个人强烈建议先用 Arduino IDE。原因很简单：

• 上手快——装好就能用，不用折腾 CMake、Makefile 这些构建工具
• 生态好——成千上万的库，传感器驱动基本都能找到现成的
• 调试方便——串口监视器一键打开，看日志、调参数都很顺手

我在项目里做过对比：用 ESP-IDF 写一个温湿度传感器驱动，从零开始大概要两天；用 Arduino IDE，找个现成库，改几行配置，两小时就搞定了。当然，后面做产品级项目时还是要切回 ESP-IDF，但学习阶段，Arduino IDE 绝对是最快的路径。

1.2 Arduino IDE 安装

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

1. 打开 arduino.cc/en/software，下载最新版（目前是 2.x 系列）
2. 双击安装包，一路默认选项就行
3. 安装完成后，桌面会出现 Arduino IDE 图标

1.3 配置 ESP32 板级支持包

Arduino IDE 默认不支持 ESP32，需要手动添加板级支持包（Board Support Package，简称 BSP）。说白了，就是告诉 IDE：「我要用 ESP32 这颗芯片，请把它的编译工具链和库文件准备好」。

具体步骤：

1. 打开 Arduino IDE，点击 File → Preferences
2. 在 Additional Boards Manager URLs 输入框里，粘贴以下地址：

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

3. 点击 OK 保存
4. 进入 Tools → Board → Boards Manager
5. 搜索 esp32，找到由 Espressif Systems 官方发布的包
6. 点击 Install，等待下载完成（大约 200MB，视网速而定）

1.4 驱动安装：让电脑认识你的板子

ESP32 开发板通常通过 USB 连接到电脑。但 USB 芯片型号不同，需要的驱动也不一样。最常见的两种方案：

怎么判断你的板子用哪种芯片？看板子上的 USB 接口附近，一般会印着芯片型号。或者插上电脑，打开设备管理器，看「端口 (COM 和 LPT)」下面显示什么。

驱动安装很简单：去芯片厂商官网下载对应驱动，双击安装就行。Windows 10/11 系统会自动联网安装大部分驱动，但 CH340 有时需要手动装。

1.5 开发板选择：别选错了型号

ESP32 系列有很多变体：ESP32、ESP32-S2、ESP32-S3、ESP32-C3、ESP32-C6……每个系列的架构和引脚定义都不一样。选错了，编译能过，但烧录进去跑不起来。

在 Arduino IDE 里选择开发板：

1. 点击 Tools → Board → ESP32 Arduino
2. 根据你的板子选择对应型号

最常见的选项：

• ESP32 Dev Module——通用选项，大部分 ESP32 开发板都能用
• NodeMCU-32S——如果你买的是 NodeMCU 风格的板子
• ESP32-WROOM-DA Module——双天线版本
• ESP32S3 Dev Module——如果你用的是 S3 芯片

不确定选哪个？先试试「ESP32 Dev Module」。这个选项兼容性最好，大部分情况下都能正常工作。

1.6 验证环境：点亮第一个 LED

环境搭好了，来验证一下。写一个最简单的程序，让板子上的 LED 闪烁。

void setup() {
  pinMode(2, OUTPUT);  // 大多数 ESP32 开发板，GPIO2 连接着板载 LED
}

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

烧录步骤：

1. 用 USB 线连接开发板和电脑
2. 在 Tools → Port 里选择对应的 COM 口
3. 点击右上角的右箭头按钮（上传）
4. 等待编译和烧录完成

如果一切顺利，你会看到板子上的 LED 开始一秒一闪。恭喜，环境搭建成功了！

1.7 本章知识结构

下面这张图把整个环境搭建的流程串起来了。你可以把它当作一张「地图」，以后每次搭建新环境时对照着走一遍。

这张图把整个流程分成了 6 步，每一步都有对应的操作。你按着顺序走，基本不会出问题。如果卡在哪一步，看看旁边的「常见问题」说明框，大部分坑我都帮你踩过了。

1.8 开发环境速查表

为了方便你以后快速配置，我把关键信息整理成了一张表。保存下来，下次重装系统时直接照着做。

好了，环境搭建就到这里。你跟着做下来，应该已经看到板子上的 LED 在闪了。接下来，咱们就可以正式开始写传感器驱动了。