MacOS 使用 VSCode 和 CMake 进行 STM32 开发配置指南

至此基本的依赖环境就已经完全搭建好了。

2. 在 VSCode 中配置开发环境

2.1 安装 VSCode

下载地址：https://code.visualstudio.com 在 Mac 上下载完成后直接拖入到应用程序中即可。

2.2 VSCode 中安装插件

在 VSCode 中安装以下插件：

• C/C++
• C/C++ Extension Pack
• CMake
• Cortex-Debug
• RTOS Views（可选，若项目用到 RTOS，调试时可以看到任务状态）

2.3 移植 STM32 项目（CMake）

打开一个工程模板（这里以 STM32F103C8T6 最小工程模板为例）。 注意：如果你会用 STM32CubeMX，那么这个开发环境是完全可以直接编译 MX 生成的项目的，只不过需要自己修改一些路径。如果是新手或者不熟练的就不要用 MX 了，建议手动管理目录以保持清爽。

输入以下命令使用 Ninja 构建输出目录：

cmake -B build -G Ninja -DCMAKE_TOOLCHAIN_FILE=toolchain-arm-none-eabi.cmake

接下来的编译结果 .elf、.bin、.hex 等文件都会存放在这个目录中。

2.4 编译下载 STM32 项目

在 .vscode 目录中我已经把编译和下载这两个操作写成了任务 Build STM32、Flash STM32： 类似 Keil 中的编译和下载这两个按钮，因此这里可以直接调用这两个任务。VSCode 任务的调用方式是 Cmd+Shift+B，先编译项目： 编译成功是这样的： 此时 build 目录下已经有了 output.elf 文件，这个就是要 Flash 到板子里的文件。 继续按下 Cmd+Shift+B，然后选择 Flash STM32，结果如下所示： 出现 Verified OK 就说明烧录成功了。

2.5 断点调试

VSCode 中的断点调试比 Keil 更好用，主要依赖 Cortex-Debug 这个插件以及 .vscode/launch.json 文件，以下是 launch.json 文件示例：

{"version":"0.2.0","configurations":[{"name":"Debug via ST-Link","type":"cortex-debug","request":"launch","servertype":"openocd","cwd":"${workspaceFolder}","executable":"${workspaceFolder}/build/output.elf","device":"STM32F103c8t6","configFiles":["interface/stlink.cfg","target/stm32f1x.cfg"],"runToEntryPoint":"main","preLaunchTask":"Build STM32","showDevDebugOutput":"none"}]}

这个文件是通用的，当你更换不同开发板时只需要把对应的名称修改一下即可，下面是属性注解：

• executable：这个是编译出来的 .elf 文件路径，烧录也是烧录这个，路径和名称一定要对。
• device：芯片名称，这个一定要正确，因为不同的芯片地址、内存大小都不一样，不对应的话调试程序可能会跑飞。
• configFiles：这两个文件是之前下载的 stlink 库里的配置文件，直接调用即可。
• preLaunchTask：这个是构建任务，因为想要调试首先就必须要有一个 .elf 文件，这个就是为了生成这个文件。

接下来就直接按下 Fn+F5 或者点击这个按钮，就可以进入断点调试了： 调试页面非常干净整洁，涉及到的变量也可以在左侧边栏实时显示，安装了 rtos 插件后还可以看到线程相关信息。