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

1. ESP32 开发环境搭建：Arduino IDE 安装、板卡配置与串口调试

做嵌入式开发，第一步永远是搭环境。很多人觉得这事简单，下载、安装、点下一步就完了。但我在项目里见过太多人卡在这一步——板子连不上、驱动装不上、端口找不到。说白了，环境没搭好，后面全是白费功夫。

这一章，我带你把 ESP32 的开发环境从头到尾捋一遍。你跟着做，半小时内应该能跑通第一个程序。

1.1 为什么选 Arduino IDE？

你可能听说过 ESP-IDF，那是乐鑫官方的开发框架，功能全，但配置复杂。我个人习惯用 Arduino IDE 做快速原型验证。原因很简单：

上手快——装好就能写，不用折腾 Makefile 和 CMake
库丰富——WiFi、WebSocket、MQTT 都有现成库
社区活跃——遇到问题，搜一下基本有答案

当然，如果你要做量产级产品，最终还是要切到 ESP-IDF。但作为学习和小型项目，Arduino IDE 完全够用。

1.2 下载与安装 Arduino IDE

去官网下载最新版。我建议下载 1.8.x 版本，虽然 2.0 已经出了，但 1.8 更稳定，插件兼容性也更好。

打开 arduino.cc/en/software
选对应操作系统的安装包（Windows 选 .exe，macOS 选 .dmg）
安装时一路默认就行，路径不要有中文

我的习惯：安装完成后，把 Arduino 的快捷方式固定到任务栏。后面调试时频繁开关，能省不少时间。

1.3 配置 ESP32 板卡支持

Arduino IDE 默认不支持 ESP32，需要手动添加板卡管理器地址。这一步很多人会漏掉。

操作步骤：

打开 Arduino IDE，点击 文件 → 首选项
在「附加开发板管理器网址」里填入：

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

点击 工具 → 开发板 → 开发板管理器
搜索 esp32，找到「ESP32 by Espressif Systems」，点击安装

注意：这个包大概 200MB，下载速度取决于网络。我曾经在客户现场用手机热点下载，等了快半小时。建议提前准备好，或者用代理加速。

安装完成后，在「工具 → 开发板」里就能看到 ESP32 系列的板卡列表了。我们选 ESP32 Dev Module，这是最通用的型号。

1.4 驱动安装——让电脑认识 ESP32

ESP32 开发板通常用 CH340 或 CP2102 芯片做 USB 转串口。Windows 10/11 一般能自动识别，但老系统可能需要手动装驱动。

怎么判断驱动有没有装好？

插上开发板，打开 设备管理器
看「端口 (COM 和 LPT)」下面有没有出现 USB Serial Port 或 CH340
如果出现黄色感叹号，说明驱动没装对

驱动下载地址：

芯片型号	驱动名称	下载方式
CH340	CH340G/CH341SER	搜索「CH340 驱动」即可找到
CP2102	CP210x USB to UART Bridge	Silicon Labs 官网下载

  避坑指南：我曾经遇到过 CH340 驱动装好后，端口还是识别不了。后来发现是 USB 线的问题——有些线只能充电，不能传数据。换一根带数据传输的线就好了。

1.5 串口调试——验证环境是否正常

环境搭好了，我们来写第一个程序。不用搞复杂，就一个简单的串口打印。

打开 Arduino IDE，新建一个文件，粘贴以下代码：

void setup() {
  Serial.begin(115200);
  Serial.println("ESP32 启动成功！");
  Serial.println("开发环境搭建完成。");
}

void loop() {
  Serial.println("系统运行中...");
  delay(1000);
}

然后按以下步骤操作：

选择板卡：工具 → 开发板 → ESP32 Dev Module
选择端口：工具 → 端口 → 选你看到的那个 COM 口
点击上传：箭头按钮，等待编译和上传

上传成功后，打开 工具 → 串口监视器，波特率设为 115200。你应该能看到：

ESP32 启动成功！
开发环境搭建完成。
系统运行中...
系统运行中...

看到这个输出，说明你的环境已经全部搭好了。

一个小技巧：如果串口监视器里显示乱码，检查一下波特率是不是 115200。ESP32 默认就是这个速率，别选错了。

1.6 知识体系总览

下面这张图，把本章的核心流程串起来了。你可以把它当作一个检查清单：

1.7 常见问题与解决

最后，我把几个高频问题列出来，你遇到了可以直接查：

问题	原因	解决方法
上传时提示「A fatal error occurred」	ESP32 没有进入下载模式	按住开发板上的 BOOT 键，再点上传
串口监视器没输出	端口选错或波特率不对	检查端口号，确认波特率是 115200
板卡管理器下载失败	网络问题或地址失效	换网络环境，或手动下载包安装
驱动装不上	系统权限或驱动版本不对	以管理员身份运行安装程序

嗯，到这里，ESP32 的开发环境就全部搭好了。你手边如果有板子，现在就可以跑起来。后面我们会在这个环境上一步步实现 WebSocket 远程控制，每一步我都会把坑提前告诉你。