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

2. 开发环境搭建：Keil/IAR/VS Code + GCC 工具链安装、OpenOCD 与调试器配置、版本控制 (Git) 入门

说实话，做嵌入式开发这么多年，我见过太多人卡在环境搭建这一步。工具链没配好，后面全是坑。今天咱们就把这事一次性理清楚。

你想想看，一个靠谱的开发环境，说白了就三样东西：编辑器/IDE、编译器/调试器、版本控制。咱们一个一个来。

2.1 IDE 选择：Keil、IAR 还是 VS Code？

很多新手会纠结选哪个。我的建议很简单：看项目，看预算，看团队。

IDE	适用场景	优点	缺点
Keil MDK	ARM Cortex-M 系列 MCU	ARM 官方支持，调试稳定，工程模板多	收费，代码量大了卡顿，License 管理麻烦
IAR EWARM	对代码体积/性能要求高的项目	编译器优化极强，调试器深度集成	贵，界面老旧，学习曲线陡
VS Code + GCC	开源项目、个人学习、团队协作	免费，插件生态丰富，Git 集成好	需要手动配置，调试器设置稍复杂

我个人习惯：公司项目用 Keil，因为团队统一；自己折腾 IoT 开发板，我全用 VS Code + GCC。免费、灵活、还能用 Git 管理代码，省心。

2.2 GCC 工具链安装：从零开始

咱们这门课主要用 ARM GCC，也就是 arm-none-eabi-gcc。为什么选它？因为开源、跨平台、而且社区活跃。

2.2.1 下载与安装

去 ARM 官方 或 GNU Arm Embedded Toolchain 页面下载对应系统的版本。
解压到某个路径，比如 C:\tools\gcc-arm-none-eabi（Windows）或 /opt/gcc-arm-none-eabi（Linux/Mac）。
把 bin 目录加到系统环境变量 PATH 里。

我曾经踩过的坑：下载了 x86_64 版本，结果电脑是 ARM 架构的 Mac，编译出来的东西全跑不起来。一定要确认你的 系统架构 和 目标芯片架构 是否匹配。

2.2.2 验证安装

打开终端，输入：

arm-none-eabi-gcc --version

如果看到版本号，说明安装成功。如果提示“命令未找到”，检查环境变量有没有配对。

2.3 VS Code 配置：从编辑器到 IDE

VS Code 本身只是个编辑器，但配上插件，它就是最强的嵌入式 IDE。我推荐这几个插件：

C/C++（微软官方）：语法高亮、智能提示、调试支持。
Cortex-Debug：专门调试 ARM Cortex-M 芯片，配合 OpenOCD 或 J-Link。
GitLens：Git 历史可视化，谁改了哪行代码一目了然。
Makefile Tools：如果你用 Makefile 构建项目，这个插件能帮你一键编译。

重点来了：VS Code 的 tasks.json 和 launch.json 是核心。前者定义编译任务，后者定义调试配置。我一般这样写：

// tasks.json 示例
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Build",
      "type": "shell",
      "command": "make",
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

// launch.json 示例（配合 OpenOCD）
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug with OpenOCD",
      "type": "cortex-debug",
      "request": "launch",
      "servertype": "openocd",
      "configFiles": ["interface/stlink.cfg", "target/stm32f4x.cfg"],
      "executable": "./build/firmware.elf"
    }
  ]
}

2.4 OpenOCD 与调试器配置

OpenOCD 是个好东西。它能把你的调试器（比如 ST-Link、J-Link、CMSIS-DAP）和 GDB 连接起来。说白了，它就是调试器与调试器之间的翻译官。

2.4.1 安装 OpenOCD

Windows：下载预编译包，解压到 C:\tools\openocd，把 bin 目录加到 PATH。
Linux：sudo apt install openocd（Ubuntu/Debian）或 sudo pacman -S openocd（Arch）。
Mac：brew install openocd。

2.4.2 调试器连接

以 ST-Link 为例，接线很简单：

SWDIO → 目标板 SWDIO
SWCLK → 目标板 SWCLK
GND → 目标板 GND
3.3V → 目标板 VCC（可选，如果目标板不自供电）

注意：有些开发板自带 ST-Link，比如 STM32 Nucleo 系列。这时候你只需要一根 USB 线，不用额外接线。我刚开始做项目时，硬是焊了一堆杜邦线，后来才发现板子自带调试器……

2.4.3 启动 OpenOCD

在终端输入：

openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

如果看到 Info : Listening on port 3333 for gdb connections，说明 OpenOCD 启动成功，正在等待 GDB 连接。

2.5 Git 入门：版本控制不是可选项

说实话，我见过太多工程师“裸奔”写代码——没有版本控制，没有备份，改坏了只能重来。Git 这东西，早学早省心。

2.5.1 基本概念

仓库 (Repository)：你的项目文件夹，Git 会跟踪里面所有文件的变化。
提交 (Commit)：一次代码快照。每次提交都有唯一的哈希值，方便回滚。
分支 (Branch)：并行开发线。主分支叫 main 或 master，功能分支随便起名。
远程仓库 (Remote)：托管在 GitHub、GitLab 或 Gitee 上的仓库，方便团队协作。

2.5.2 常用命令

命令	作用
`git init`	初始化本地仓库
`git add .`	把所有改动加入暂存区
`git commit -m "描述"`	提交暂存区的改动
`git push`	把本地提交推送到远程仓库
`git pull`	拉取远程仓库的最新代码
`git log`	查看提交历史

2.5.3 嵌入式项目的 .gitignore

嵌入式项目有很多编译产物，比如 .o 文件、.hex 文件、.bin 文件。这些不需要提交到 Git。我一般这样写：

# 编译产物
build/
*.o
*.elf
*.hex
*.bin

# IDE 配置文件
.idea/
.vscode/
*.uvoptx
*.uvguix

# 系统文件
.DS_Store
Thumbs.db

一个小技巧：每次提交前，用 git status 看看哪些文件会被提交。如果发现不该提交的文件混进来了，赶紧加到 .gitignore 里。

2.6 知识体系总览

下面这张图，把咱们这一章的核心逻辑串起来了。你一看就明白：

2.7 避坑指南

最后，分享几个我亲身踩过的坑：

路径不要有中文和空格：GCC 和 OpenOCD 对中文路径支持很差。我曾经把项目放在“桌面/我的项目”里，编译死活报错，改到英文路径就好了。
调试器驱动要装对：ST-Link 需要装驱动，J-Link 也是。Windows 上插上调试器没反应，八成是驱动没装。
Git 提交信息要写清楚：别写“fix bug”这种废话。我一般写“修复 UART 接收中断丢失问题”，半年后回头看还能想起来当时在干嘛。

环境搭建这事，一次配好，后面省心。别嫌麻烦，磨刀不误砍柴工。