3. 开发环境搭建:工欲善其事,必先利其器
说实话,我见过太多人一上来就写代码,结果卡在环境配置上大半天。嵌入式开发有个特点——环境搭好了,项目就成功了一半。今天咱们就把这套工具链彻底搞定。
3.1 Arduino IDE 安装与配置
Arduino IDE 是我们最常用的开发工具。它轻量、简单,特别适合 ESP32 这类芯片。
下载与安装
- 去官网下载最新版(我建议用 2.x 版本,界面清爽很多)
- Windows 用户直接点 exe,一路 Next 就行
- Mac 用户拖到 Applications 文件夹
- Linux 用户用命令行解压,或者用 snap 安装
首次配置
打开 IDE 后,先做两件事:
- 设置语言:File → Preferences → Editor Language → 简体中文
- 开启详细输出: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,下载速度看网络情况。我建议用手机热点试试,有时候比公司网络快。
验证安装
安装完成后,在 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”,说明驱动正常。如果显示“未知设备”或者有个黄色感叹号,那就得装了。
安装步骤
- 去 WCH 官网下载 CH340 驱动(或者用我提供的离线包)
- Windows 用户运行 SETUP.EXE
- Mac 用户安装 CH34x_Install_V1.5.pkg
- Linux 用户一般内核自带,不需要额外装
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
远程仓库(可选)
如果你想备份到云端,可以用 GitHub 或 Gitee。操作很简单:
# 关联远程仓库
git remote add origin https://github.com/你的用户名/你的仓库.git
# 推送代码
git push -u origin master
嗯,到这里,开发环境就全部搭好了。你可能会觉得步骤有点多,但相信我——一次配置好,后面能省下无数时间。下一章我们开始写真正的代码。