基于 ESP32、Arduino 的环境安装

📘 基于 ESP32 和 Arduino 的开发环境安装教程

本教程将带你完成 ESP32 的开发环境配置，使用 Arduino IDE 作为开发工具。通过本文，你将能够成功连接 ESP32，并编写上传第一个程序。

---

所需硬件和软件

🧰 硬件准备

名称	说明
ESP32 开发板	型号 DevKit V1
数据线	用于连接电脑上传代码（Micro-USB 或 Type-C）
驱动程序	如 CP210x（根据开发板芯片而定）

---

安装 Arduino IDE

1. 打开官网下载 Arduino IDE：
   👉 https://www.arduino.cc/en/software
2. 下载与你的操作系统匹配的版本（Windows/macOS/Linux）
3. 安装并启动 Arduino IDE

我这里是用的 macOs 系统

---

配置 ESP32 开发板支持

1. 打开 Arduino IDE → “文件” → “首选项”

2. 在“附加开发板管理器网址”中添加：

✅ 稳定版地址（推荐使用）

• 🌍 GitHub 全球镜像
  https://espressif.github.io/arduino-esp32/package_esp32_index...
  https://raw.githubusercontent.com/espressif/arduino-esp32/gh-...
• 🇨🇳 适用于中国大陆用户的 Jihulab 镜像
  https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/...

能填写多个开发版管理地址，只换行就可以

等待下载ESP32 Arduino 开发版的索引文件 package_esp32_dev_index.json

3. 点击 “工具” → “开发板” → “开发板管理器”，搜索 esp32

找到 Espressif Systems 提供的 esp32 开发板包，点击 安装, 这里我已经安装完成了，没有安装过会显示安装按钮

---

连接 ESP32 开发板

1. 连接 ESP32 开发板

将 ESP32 开发板通过 USB 连接到电脑。
⚠️ 注意： 在开始之前，请确保已安装对应的 USB 驱动程序。

2. 查看串口（适用于 macOS / Linux）

你可以使用终端命令查看当前可用的串口设备。

不同操作系统下，串口设备的名称格式如下：

• 🐧 Linux：设备路径通常以 /dev/tty 开头
  示例命令：

  ls /dev/tty*

• 🍎 Linux：设备路径通常以 /dev/cu. 开头
  示例命令：

  ls /dev/cu.*

  

⚠️ 这里未发现 ESP32 串口

ESP32 开发板常用的 USB 转串口芯片包括：

• CP210x（Silicon Labs）
• CH340（WCH）
  请根据你开发板使用的芯片型号安装相应驱动：
• CP210x 驱动下载（官方）
• CH340 驱动下载（第三方）

选择自己系统对应的版本

安装成功后你应该能看到类似如下的串口(我这里是 macOS： 操作系统)

• macOS： /dev/cu.SLAB_USBtoUART（CP210x）、/dev/cu.usbserial-0001

📌 小贴士：部分 macOS 系统会阻止第三方驱动自动加载，安装后如仍无串口，请在“系统设置 → 安全性与隐私”中允许驱动加载。

选择开发板与串口

1. 在 Arduino IDE 中依次点击 “工具” → “开发板”，选择你的 ESP32 开发板型号（如：ESP32 Dev Module）

2. 点击 “工具” → “端口”，选择对应的串口号（如 COM3、/dev/cu.SLAB_USBtoUART）

测试上传示例程序

1. 点击 “文件” → “示例” → “01.Basics” → Blink

void setup() {
  // 这里原本是 LED_BUILTIN，由于没有定义 LED_BUILTIN, 我们这里把它改成 2 就行
  // 或者在代码最前面定义 #define LED_BUILTIN 2
  pinMode(2, OUTPUT); // 初始化 GPIO2 
}

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

2. 将示例代码上传至 ESP32，等待编译完成

3. 开发板上连接 LED 的引脚将开始闪烁，表示上传成功

---

常见问题排查

• 找不到串口：
• 检查数据线是否为数据线（非充电线）
• 确认驱动是否安装成功
• 更换 USB 接口或重启 IDE
• 上传失败（报错 “Failed to connect”）：
• 在上传时，按住 ESP32 板上的 BOOT 键，直到开始上传

---

参考链接

• Arduino 官方网站
• ESP32 官网
• 驱动下载（CP210x）

---