VSCode F7 一键编译 STM32 完整配置指南

软件环境：
1、Visual Studio Code 版本: 1.112.0 (system setup)
2、STM32CubeIDE for Visual Studio Code （VSCode插件）
3、CMake 4.3.0
4、STM32CubeProgrammer‌
5、gcc -arm-none-eabi-10.3-2021.10-win32
————————————————
版权声明：本文为CSDN博主「知足常玩蜘蛛纸牌」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/qq_40686336/article/details/159380412

配置目标

实现 F7 一键编译 STM32 工程，生成 Debug 版本的 .hex 固件文件，与 F8 烧录功能配合，形成标准化开发流程。

前提准备

确保工程已完成 CMake 配置，能够正常生成 build 文件夹及编译产物。VSCode 需安装 CMake Tools 插件，工程编译类型为 Debug。

核心原理

VSCode 默认将 F7 绑定为 CMake 构建快捷键，通过校准 CMake 编译路径和配置默认构建目标，实现一键编译。

配置步骤

确认 CMake 工程配置
打开工程根目录，检查 CMakeLists.txt 文件是否存在。确认 build/Debug 路径为默认编译输出目录。在 VSCode 右侧 CMake 工具栏中，验证构建类型为 Debug，编译器及芯片型号（STM32G43x）匹配。

校准默认构建目标
通过 Ctrl+Shift+P 打开命令面板，输入 CMake: Select Default Build Target，选择主工程对应的编译目标（如 led）。确保 F7 触发时直接编译主工程。

配置 F7 快捷键
若 F7 无响应或触发其他功能，手动配置快捷键：

1. 按 Ctrl+K Ctrl+S 打开快捷键设置。
2. 点击右上角 {} 图标，编辑 keybindings.json。
3. 添加以下配置：

{
    "key": "f7",
    "command": "cmake.build",
    "when": "editorFocus || terminalFocus",
    "description": "STM32一键编译（生成Debug版hex固件）"
}

测试 F7 一键编译
修改代码后按 F7，观察终端输出。成功编译后，build/Debug 目录下会生成 .hex 文件。若无报错，可继续按 F8 烧录。

编译成功标准

终端显示 [build] Build finished with exit code 0，表明编译成功，.hex 文件已生成。

常见问题排查

• F7 无反应：检查 CMake Tools 插件是否安装，重新选择默认构建目标。
• 编译报错或无 .hex 文件：检查代码语法、CubeMX 配置或 CMake 路径。
• F7 触发其他功能：在 keybindings.json 中强制绑定 F7 为 cmake.build。
• 找不到 .hex 文件：确认构建类型为 Debug，路径为 build/Debug/xxx.hex。

标准化开发流程

1. 编写或修改代码。
2. 按 F7 编译，等待成功提示。
3. 按 F8 选择 .hex 文件烧录。
4. 烧录完成后芯片自动复位运行。

配置亮点

• 基于原生 VSCode 和 CMake Tools 功能，无需第三方脚本。
• 单键操作，无需手动输入命令或选择任务。
• 与 F8 烧录功能形成闭环，逻辑清晰。
• 适配所有基于 CMake 的 STM32 工程，无需重复配置。