3. 开发环境搭建:工欲善其事,必先利其器

说实话,我见过太多人一上来就写代码,结果卡在环境配置上大半天。嵌入式开发有个特点——环境搭好了,项目就成功了一半。今天咱们就把这套工具链彻底搞定。

3.1 Arduino IDE 安装与配置

Arduino IDE 是我们最常用的开发工具。它轻量、简单,特别适合 ESP32 这类芯片。

下载与安装

  • 去官网下载最新版(我建议用 2.x 版本,界面清爽很多)
  • Windows 用户直接点 exe,一路 Next 就行
  • Mac 用户拖到 Applications 文件夹
  • Linux 用户用命令行解压,或者用 snap 安装
我的习惯:安装路径不要有中文。以前有个学员路径里带了“项目”两个字,结果编译死活报错,折腾了半小时才发现是路径问题。

首次配置

打开 IDE 后,先做两件事:

  1. 设置语言:File → Preferences → Editor Language → 简体中文
  2. 开启详细输出:File → Preferences → 勾选“编译时显示详细输出”和“上传时显示详细输出”

为什么要开详细输出?因为报错信息都在里面。你想想看,如果只显示一个“编译失败”,你根本不知道哪里出了问题。

3.2 ESP32 板级支持包安装

Arduino IDE 默认不支持 ESP32。我们需要手动添加板级支持包。

添加开发板管理器地址

打开 File → Preferences,在“附加开发板管理器网址”里填入:

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

然后去 Tools → Board → Boards Manager,搜索“ESP32”,点击安装。这个包大概 200MB,下载速度看网络情况。我建议用手机热点试试,有时候比公司网络快。

注意:安装过程中不要关闭 IDE。我曾经手贱关了一次,结果包损坏了,只能删掉重装。嗯,别学我。

验证安装

安装完成后,在 Tools → Board 里应该能看到 ESP32 系列。选一个你手头的型号,比如 ESP32 Dev Module。

写个最简单的测试代码:

void setup() {
  Serial.begin(115200);
  Serial.println("Hello, ESP32!");
}

void loop() {
  delay(1000);
}

点击上传按钮。如果一切顺利,你会看到串口输出“Hello, ESP32!”。

3.3 CH340 驱动安装

很多 ESP32 开发板用的是 CH340 芯片做 USB 转串口。Windows 10/11 通常能自动识别,但有些系统需要手动装驱动。

怎么判断是否需要装驱动?

把开发板插到电脑上,打开设备管理器。如果看到“CH340”或者“USB-SERIAL CH340”,说明驱动正常。如果显示“未知设备”或者有个黄色感叹号,那就得装了。

安装步骤

  1. 去 WCH 官网下载 CH340 驱动(或者用我提供的离线包)
  2. Windows 用户运行 SETUP.EXE
  3. Mac 用户安装 CH34x_Install_V1.5.pkg
  4. Linux 用户一般内核自带,不需要额外装
避坑指南:我曾经遇到过一个问题——驱动装好了,但设备管理器里还是感叹号。后来发现是 USB 线的问题。有些劣质线只能充电,不能传数据。换根好点的线就好了。

3.4 串口调试工具使用

Arduino IDE 自带串口监视器,但功能有限。我推荐用 Serial Monitor 或者 Putty

Arduino 自带串口监视器

  • Tools → Serial Monitor(或者快捷键 Ctrl+Shift+M)
  • 设置波特率:要和代码里的 Serial.begin() 一致
  • 可以选择“换行符”或“回车换行”

第三方工具推荐

工具名称 优点 适用场景
Serial Monitor (IDE自带) 简单、集成 快速调试
Putty 支持 SSH、串口、Telnet 远程调试
CoolTerm 支持数据记录、十六进制显示 数据分析

我个人习惯用 CoolTerm。它可以把串口数据保存成文件,方便后期分析。有一次我在调试传感器数据,就是靠 CoolTerm 的记录功能找到了一个间歇性故障。

3.5 版本控制(Git)入门

你可能觉得一个人做项目不需要 Git。但说实话,我吃过亏——有一次改了一整天代码,结果发现改错了,想回退却回不去。从那以后,任何项目我都用 Git。

安装 Git

  • Windows:下载 Git for Windows,一路默认安装
  • Mac:brew install git
  • Linux:sudo apt install git

基本配置

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

常用命令

你只需要记住这几个命令,就能应付 90% 的场景:

# 初始化仓库
git init

# 添加文件到暂存区
git add .

# 提交到本地仓库
git commit -m "第一次提交:搭建开发环境"

# 查看状态
git status

# 查看历史
git log --oneline
我的工作流:每次写完一个功能模块,就 git add 和 git commit 一次。这样如果后面改坏了,可以轻松回退到上一个正常版本。你想想看,是不是比手动备份文件方便多了?

远程仓库(可选)

如果你想备份到云端,可以用 GitHub 或 Gitee。操作很简单:

# 关联远程仓库
git remote add origin https://github.com/你的用户名/你的仓库.git

# 推送代码
git push -u origin master

嗯,到这里,开发环境就全部搭好了。你可能会觉得步骤有点多,但相信我——一次配置好,后面能省下无数时间。下一章我们开始写真正的代码。