VS Code.code-workspace配置指南Python / C/C 嵌入式开发基于 STM32F407 ARM GCC clangd Python 项目的实战配置文档目录什么是 .code-workspace 文件文件基础结构布局与外观侧边栏、面板与编辑器布局编辑器外观与行为代码编辑优化C/C 专项配置clangdPython 专项配置其他语言专项配置文件排除与搜索排除终端与调试Build TasksCMake Ninja附完整可复用模板1. 什么是.code-workspace文件.code-workspace是 VS Code 的多根工作区配置文件相比.vscode/settings.json有以下优势特性.vscode/settings.json.code-workspace作用范围仅当前项目可跨多个项目文件夹聚合共享方式随项目提交 Git独立文件可放在任意位置多文件夹不支持支持folders: [...]推荐启动方式code .code xxx.code-workspace最佳实践将有硬件依赖的 C/C 项目如 STM32 HAL 库在外置目录通过folders聚合到同一个工作区同时统一所有编辑器行为。2. 文件基础结构{ // ① 工作区包含哪些文件夹 folders: [ { path: . }, // 当前目录可写多个路径 ], // ② 全局 Settings会继承到所有文件夹 settings: { // ... 各种配置项 ... }, // ③ 自动化 Tasks编译、清理等 tasks: { version: 2.0.0, tasks: [ /* ... */ ], }, }注意VS Code 工作区只认settings、folders、launch、tasks、extensions这几个顶层键。JSON 标准不允许注释但 VS Code 使用jsonc模式时注释可见。3. 布局与外观// 布局与外观 workbench.colorTheme: GNOME2-like, // 颜色主题 workbench.iconTheme: vs-seti, // 文件图标主题 workbench.productIconTheme: emoji-product-icons, // IDE 内部图标风格 workbench.editor.empty.hint: hidden, // 隐藏空编辑器的大 Logo 提示 workbench.startupEditor: none, // 启动时不打开上次的文件 workbench.editor.showTabs: multiple, // 允许多标签页 workbench.tree.renderIndentGuides: always, // 文件浏览器缩进引导线常用配色推荐主题名称风格适合场景Nord冷色调、低对比度长时间编码Nord Wave暖色变体夜间使用GitHub Dark Dimmed柔和深色GitHub 用户首选GNOME2-like经典 Gnome 配色怀旧 Linux 风格4. 侧边栏、面板与编辑器布局// 侧边栏与面板 workbench.sideBar.location: left, // 侧边栏靠左 workbench.panel.defaultLocation: bottom, // 终端面板在底部 workbench.statusBar.visible: true, // 显示底部状态栏 // 编辑器布局 workbench.editor.splitOnDragAndDrop: true, // 拖文件到边缘 → 自动分屏 workbench.editor.enablePreview: false, // 单击直接打开不覆盖当前标签 workbench.editor.limit.enabled: true, // 限制打开标签数 workbench.editor.limit.perEditorGroup: true, // 每组编辑器最多 5 个标签 // 快速访问 workbench.quickOpen.closeOnFocusLost: true, // 失焦时关闭快速搜索 workbench.commandPalette.preserveInput: true, // 保留命令面板历史输入enablePreview: false非常重要默认 VS Code 单击文件以「预览模式」打开再点另一个文件就会覆盖。设为false后双击才覆盖避免手滑丢失当前编辑内容。5. 编辑器外观与行为// 编辑器外观与行为 editor.fontSize: 14, editor.fontFamily: Monaco, Courier New, monospace, editor.tabSize: 4, // Tab 4 空格 editor.insertSpaces: true, // 用空格替代 Tab 字符 editor.detectIndentation: false, // 不自动检测缩进风格 editor.renderWhitespace: none, // 不显示空格和 Tab 符号 editor.lineNumbers: on, // 显示行号 editor.minimap.enabled: false, // 关闭 minimap节省性能 editor.cursorStyle: line, // 光标样式竖线 editor.smoothScrolling: true, // 平滑滚动 editor.lineHeight: 20, // 行高 editor.letterSpacing: 0.4, // 字间距 editor.fontLigatures: true, // 连字 → ⇒! → ≠推荐字体平台推荐字体WindowsCascadia Code,Fira Code,ConsolasmacOSSF Mono,Fira CodeLinuxFira Code,JetBrains Mono通用兼容性最好Monaco,Courier New,monospace6. 代码编辑优化// 代码编辑优化 editor.formatOnSave: true, // 保存时自动格式化 editor.formatOnPaste: false, // 粘贴时不自动格式化 editor.autoClosingBrackets: always, // 自动补全括号 [] {} editor.autoClosingQuotes: always, // 自动补全引号 editor.suggestSelection: first, // 按 Enter 直接选第一个建议 editor.quickSuggestions: { // 快速建议输入时触发 comments: true, strings: true, other: true },7. C/C 专项配置clangd7.1 为什么用 clangd 而不是 Microsoft C/C IntelliSense对比维度Microsoft C/Cclangd索引速度较慢Tag Parser极快基于 Clang AST补全质量一般精确同 Clang 编译器语义头文件跳转有时出错准确跨编辑器仅 VS Code可用于 Vim / Emacs / Sublime7.2 核心配置// clangd 核心配置 C_Cpp.intelliSenseEngine: clangd, // ★ 关键切换到 clangd 引擎 clangd.path: clangd, // 若不在 PATH 中则写绝对路径 C_Cpp.codeFolding: disabled, // 关闭旧折叠交给 clangd clangd.arguments: [ --background-index, // 后台建索引加速跳转 --clang-tidy, // 启用静态检查 --clang-tidy-checksreadability-redundant-delete, bugprone-suspicious-semicolon, --completion-styledetailed, // 详细补全提示 --header-insertioniwyu, // 自动添加缺失头文件 // ★ 告诉 clangd 用什么编译器做头文件查询 --query-driverC:/Program Files (x86)/GNU Arm Embedded Toolchain/10 2021.10/bin/arm-none-eabi-gcc.exe ],7.3 头文件路径fallbackFlags当项目没有compile_commands.json时clangd 需要通过fallbackFlags知道头文件在哪clangd.fallbackFlags: [ // 全局宏定义 -DUSE_HAL_DRIVER, -DSTM32F407xx, // 系统头文件 -IC:/Program Files (x86)/GNU Arm Embedded Toolchain/10 2021.10/arm-none-eabi/include, // STM32 HAL 库头文件外置 -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/STM32F4xx_HAL_Driver/Inc, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/STM32F4xx_HAL_Driver/Inc/Legacy, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/CMSIS/Device/ST/STM32F4xx/Include, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/CMSIS/Include, // 项目自身头文件 -I./Core/Inc, -I./Common, -I./Code, -I./OnChip, -I./OffChip ],如果你使用 CMake 生成compile_commands.json可在 CMakeLists.txt 中加set(CMAKE_EXPORT_COMPILE_COMMANDS ON)clangd 会自动从该文件读取-I和-D此时可以删除fallbackFlags。7.4 保存时自动修复 格式化// 保存时自动 clang-tidy 修复 editor.codeActionsOnSave: { source.fixAll.clang-tidy: always }, // 格式化工具 clang-format.executable: D:/LLVM/mingw/bin/clang-format.exe, // C 文件专属 [c]: { editor.formatOnSave: true, editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd }, // C 文件专属 [cpp]: { editor.formatOnSave: true, editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd }, // 格式化风格LLVM 风格 4 空格缩进 C_Cpp.clang_format_style: { BasedOnStyle: LLVM, IndentWidth: 4 },8. Python 专项配置// Python 格式化Black python.formatting.provider: black, python.formatting.blackPath: black, python.formatting.blackArgs: [ --line-length88, // 每行最多 88 字符 --skip-string-normalization // 保留字符串原来的引号风格 ], // Python 文件专属设置 [python]: { editor.insertSpaces: true, // Python 必须用空格缩进 editor.tabSize: 4, // PEP 8 标准4 空格 editor.formatOnSave: true, editor.defaultFormatter: ms-python.black-formatter },Python 推荐扩展扩展 ID作用ms-python.python核心 Python 支持ms-python.black-formatterBlack 代码格式化ms-python.isortimport 语句排序ms-python.flake8代码风格检查如需保存时自动整理 import在[python]中添加editor.codeActionsOnSave: { source.organizeImports: true }9. 其他语言专项配置JSON[json]: { editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode },YAML[yaml]: { editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode, prettier.proseWrap: never // YAML 不自动折行 },Markdown[markdown]: { editor.quickSuggestions: { other: true, comments: false, strings: true }, editor.wordWrap: on, editor.renderWhitespace: none, editor.tabSize: 2, editor.autoClosingQuotes: always, editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode }, // Markdown 预览设置 markdown.preview.fontSize: 14, markdown.preview.lineHeight: 1.5, markdown.preview.breaks: true, // 换行即 br markdown.preview.linkify: true, // 自动识别链接 markdown.preview.doubleClickToSwitchToEditor: false, // Markdown 扩展设置需安装 yzhang.markdown-all-in-one markdown.extension.toc.levels: 2..4, markdown.extension.toc.unorderedList.marker: -, markdown.extension.preview.autoShowPreviewToSide: true,Makefile[makefile]: { editor.insertSpaces: false, // ★ Makefile 必须用 Tab editor.tabSize: 8 },10. 文件排除与搜索排除// 文件浏览器隐藏 files.exclude: { **/.git: true // **/.vscode: true, // 可选隐藏配置目录 // **/*.exe: true, // 可选隐藏可执行文件 // **/*.o: true // 可选隐藏编译产物 }, // 全局搜索忽略 search.exclude: { **/build: true, // CMake 构建目录 **/node_modules: true, // Node.js 依赖 **/.vscode: true // VSCode 配置目录 },11. 终端与调试// 终端与调试 terminal.integrated.defaultProfile.windows: Command Prompt, // 可改为 Git Bash terminal.integrated.fontSize: 12, debug.console.fontSize: 12, debug.showBreakpointsInOverviewRuler: true, // 滚动条显示断点标记Windows 用户注意如果安装了 Git Bash 或 MSYS2可将defaultProfile.windows改为Git Bash。12. Build TasksCMake Ninja嵌入式项目推荐CMake Ninja组合比 Make 更快且跨平台行为一致tasks: { version: 2.0.0, tasks: [ { label: CMake: 配置 Ninja, type: shell, command: cmake -B build -S . -G Ninja, group: build, problemMatcher: [], detail: 不切换目录生成 Ninja 构建文件 }, { label: CMake: 正常编译, type: shell, command: cmake --build build, group: build, problemMatcher: [], detail: 常规编译不显示完整命令行 }, { label: CMake: 详细编译 显示完整命令行, type: shell, command: ninja -v -C build, group: build, problemMatcher: [], detail: 打印每一条编译链接命令方便排错 }, { label: CMake: 清理工程, type: shell, command: cmake --build build --target clean, group: build, problemMatcher: [] } ] }使用方式CtrlShiftB→ 选择对应 Task或在命令面板CtrlShiftP输入Tasks: Run Task推荐工作流第一步 CMake: 配置 Ninja → 生成 build 目录和构建文件 第二步 CMake: 正常编译 → 增量编译 排错 CMake: 详细编译 → 排查编译错误时使用 重编 CMake: 清理工程 → 全量重编前先清理13. 附完整可复用模板将下面的内容保存为my_project.code-workspace修改其中的路径和宏定义即可用于自己的项目{ folders: [{ path: . }], settings: { // 布局与外观 workbench.colorTheme: Nord, workbench.iconTheme: vs-seti, workbench.startupEditor: none, workbench.editor.enablePreview: false, workbench.tree.renderIndentGuides: always, // 编辑器通用 editor.fontSize: 14, editor.fontFamily: Cascadia Code, Fira Code, Consolas, monospace, editor.tabSize: 4, editor.insertSpaces: true, editor.formatOnSave: true, editor.minimap.enabled: false, editor.fontLigatures: true, editor.detectIndentation: false, // C/C (clangd) C_Cpp.intelliSenseEngine: clangd, clangd.path: clangd, clangd.arguments: [ --background-index, --clang-tidy, --completion-styledetailed, --header-insertioniwyu, ], clangd.fallbackFlags: [ // ← 在此填写你的 -D 宏 和 -I 路径 ], [c]: { editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd, }, [cpp]: { editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd, }, editor.codeActionsOnSave: { source.fixAll.clang-tidy: always, }, // Python [python]: { editor.tabSize: 4, editor.defaultFormatter: ms-python.black-formatter, }, // 其他语言 [json]: { editor.defaultFormatter: esbenp.prettier-vscode, }, [yaml]: { editor.defaultFormatter: esbenp.prettier-vscode, }, [markdown]: { editor.wordWrap: on, editor.tabSize: 2, editor.defaultFormatter: esbenp.prettier-vscode, }, [makefile]: { editor.insertSpaces: false, editor.tabSize: 8, }, // 排除 files.exclude: { **/.git: true, }, search.exclude: { **/build: true, **/node_modules: true, **/.vscode: true, }, }, tasks: { version: 2.0.0, tasks: [ { label: CMake: 配置, type: shell, command: cmake -B build -S . -G Ninja, group: build, }, { label: CMake: 编译, type: shell, command: cmake --build build, group: build, }, { label: CMake: 清理, type: shell, command: cmake --build build --target clean, group: build, }, ], }, }小结关注点核心配置项外观统一colorTheme、iconTheme、fontFamily编辑器体验enablePreview: false、formatOnSave: trueC/C 智能提示clangd.argumentsclangd.fallbackFlagsPython 格式化ms-python.black-formatter构建自动化tasks中配置 CMake / Ninja 命令工作区隔离files.excludesearch.exclude一步到位将.code-workspace文件放到项目目录终端执行code my_project.code-workspace即可加载全部配置。团队成员只需修改本地的fallbackFlags路径即可无缝协作。文档基于实际 STM32F407 ARM GCC Python 混合项目编写更新时间2026-09-11
VS Code.code-workspace配置指南Python / C/C 嵌入式开发基于 STM32F407 ARM GCC clangd Python 项目的实战配置文档目录什么是 .code-workspace 文件文件基础结构布局与外观侧边栏、面板与编辑器布局编辑器外观与行为代码编辑优化C/C 专项配置clangdPython 专项配置其他语言专项配置文件排除与搜索排除终端与调试Build TasksCMake Ninja附完整可复用模板1. 什么是.code-workspace文件.code-workspace是 VS Code 的多根工作区配置文件相比.vscode/settings.json有以下优势特性.vscode/settings.json.code-workspace作用范围仅当前项目可跨多个项目文件夹聚合共享方式随项目提交 Git独立文件可放在任意位置多文件夹不支持支持folders: [...]推荐启动方式code .code xxx.code-workspace最佳实践将有硬件依赖的 C/C 项目如 STM32 HAL 库在外置目录通过folders聚合到同一个工作区同时统一所有编辑器行为。2. 文件基础结构{ // ① 工作区包含哪些文件夹 folders: [ { path: . }, // 当前目录可写多个路径 ], // ② 全局 Settings会继承到所有文件夹 settings: { // ... 各种配置项 ... }, // ③ 自动化 Tasks编译、清理等 tasks: { version: 2.0.0, tasks: [ /* ... */ ], }, }注意VS Code 工作区只认settings、folders、launch、tasks、extensions这几个顶层键。JSON 标准不允许注释但 VS Code 使用jsonc模式时注释可见。3. 布局与外观// 布局与外观 workbench.colorTheme: GNOME2-like, // 颜色主题 workbench.iconTheme: vs-seti, // 文件图标主题 workbench.productIconTheme: emoji-product-icons, // IDE 内部图标风格 workbench.editor.empty.hint: hidden, // 隐藏空编辑器的大 Logo 提示 workbench.startupEditor: none, // 启动时不打开上次的文件 workbench.editor.showTabs: multiple, // 允许多标签页 workbench.tree.renderIndentGuides: always, // 文件浏览器缩进引导线常用配色推荐主题名称风格适合场景Nord冷色调、低对比度长时间编码Nord Wave暖色变体夜间使用GitHub Dark Dimmed柔和深色GitHub 用户首选GNOME2-like经典 Gnome 配色怀旧 Linux 风格4. 侧边栏、面板与编辑器布局// 侧边栏与面板 workbench.sideBar.location: left, // 侧边栏靠左 workbench.panel.defaultLocation: bottom, // 终端面板在底部 workbench.statusBar.visible: true, // 显示底部状态栏 // 编辑器布局 workbench.editor.splitOnDragAndDrop: true, // 拖文件到边缘 → 自动分屏 workbench.editor.enablePreview: false, // 单击直接打开不覆盖当前标签 workbench.editor.limit.enabled: true, // 限制打开标签数 workbench.editor.limit.perEditorGroup: true, // 每组编辑器最多 5 个标签 // 快速访问 workbench.quickOpen.closeOnFocusLost: true, // 失焦时关闭快速搜索 workbench.commandPalette.preserveInput: true, // 保留命令面板历史输入enablePreview: false非常重要默认 VS Code 单击文件以「预览模式」打开再点另一个文件就会覆盖。设为false后双击才覆盖避免手滑丢失当前编辑内容。5. 编辑器外观与行为// 编辑器外观与行为 editor.fontSize: 14, editor.fontFamily: Monaco, Courier New, monospace, editor.tabSize: 4, // Tab 4 空格 editor.insertSpaces: true, // 用空格替代 Tab 字符 editor.detectIndentation: false, // 不自动检测缩进风格 editor.renderWhitespace: none, // 不显示空格和 Tab 符号 editor.lineNumbers: on, // 显示行号 editor.minimap.enabled: false, // 关闭 minimap节省性能 editor.cursorStyle: line, // 光标样式竖线 editor.smoothScrolling: true, // 平滑滚动 editor.lineHeight: 20, // 行高 editor.letterSpacing: 0.4, // 字间距 editor.fontLigatures: true, // 连字 → ⇒! → ≠推荐字体平台推荐字体WindowsCascadia Code,Fira Code,ConsolasmacOSSF Mono,Fira CodeLinuxFira Code,JetBrains Mono通用兼容性最好Monaco,Courier New,monospace6. 代码编辑优化// 代码编辑优化 editor.formatOnSave: true, // 保存时自动格式化 editor.formatOnPaste: false, // 粘贴时不自动格式化 editor.autoClosingBrackets: always, // 自动补全括号 [] {} editor.autoClosingQuotes: always, // 自动补全引号 editor.suggestSelection: first, // 按 Enter 直接选第一个建议 editor.quickSuggestions: { // 快速建议输入时触发 comments: true, strings: true, other: true },7. C/C 专项配置clangd7.1 为什么用 clangd 而不是 Microsoft C/C IntelliSense对比维度Microsoft C/Cclangd索引速度较慢Tag Parser极快基于 Clang AST补全质量一般精确同 Clang 编译器语义头文件跳转有时出错准确跨编辑器仅 VS Code可用于 Vim / Emacs / Sublime7.2 核心配置// clangd 核心配置 C_Cpp.intelliSenseEngine: clangd, // ★ 关键切换到 clangd 引擎 clangd.path: clangd, // 若不在 PATH 中则写绝对路径 C_Cpp.codeFolding: disabled, // 关闭旧折叠交给 clangd clangd.arguments: [ --background-index, // 后台建索引加速跳转 --clang-tidy, // 启用静态检查 --clang-tidy-checksreadability-redundant-delete, bugprone-suspicious-semicolon, --completion-styledetailed, // 详细补全提示 --header-insertioniwyu, // 自动添加缺失头文件 // ★ 告诉 clangd 用什么编译器做头文件查询 --query-driverC:/Program Files (x86)/GNU Arm Embedded Toolchain/10 2021.10/bin/arm-none-eabi-gcc.exe ],7.3 头文件路径fallbackFlags当项目没有compile_commands.json时clangd 需要通过fallbackFlags知道头文件在哪clangd.fallbackFlags: [ // 全局宏定义 -DUSE_HAL_DRIVER, -DSTM32F407xx, // 系统头文件 -IC:/Program Files (x86)/GNU Arm Embedded Toolchain/10 2021.10/arm-none-eabi/include, // STM32 HAL 库头文件外置 -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/STM32F4xx_HAL_Driver/Inc, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/STM32F4xx_HAL_Driver/Inc/Legacy, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/CMSIS/Device/ST/STM32F4xx/Include, -ID:/Mycode/STM32_F407_GCC_TPL/Drivers/CMSIS/Include, // 项目自身头文件 -I./Core/Inc, -I./Common, -I./Code, -I./OnChip, -I./OffChip ],如果你使用 CMake 生成compile_commands.json可在 CMakeLists.txt 中加set(CMAKE_EXPORT_COMPILE_COMMANDS ON)clangd 会自动从该文件读取-I和-D此时可以删除fallbackFlags。7.4 保存时自动修复 格式化// 保存时自动 clang-tidy 修复 editor.codeActionsOnSave: { source.fixAll.clang-tidy: always }, // 格式化工具 clang-format.executable: D:/LLVM/mingw/bin/clang-format.exe, // C 文件专属 [c]: { editor.formatOnSave: true, editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd }, // C 文件专属 [cpp]: { editor.formatOnSave: true, editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd }, // 格式化风格LLVM 风格 4 空格缩进 C_Cpp.clang_format_style: { BasedOnStyle: LLVM, IndentWidth: 4 },8. Python 专项配置// Python 格式化Black python.formatting.provider: black, python.formatting.blackPath: black, python.formatting.blackArgs: [ --line-length88, // 每行最多 88 字符 --skip-string-normalization // 保留字符串原来的引号风格 ], // Python 文件专属设置 [python]: { editor.insertSpaces: true, // Python 必须用空格缩进 editor.tabSize: 4, // PEP 8 标准4 空格 editor.formatOnSave: true, editor.defaultFormatter: ms-python.black-formatter },Python 推荐扩展扩展 ID作用ms-python.python核心 Python 支持ms-python.black-formatterBlack 代码格式化ms-python.isortimport 语句排序ms-python.flake8代码风格检查如需保存时自动整理 import在[python]中添加editor.codeActionsOnSave: { source.organizeImports: true }9. 其他语言专项配置JSON[json]: { editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode },YAML[yaml]: { editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode, prettier.proseWrap: never // YAML 不自动折行 },Markdown[markdown]: { editor.quickSuggestions: { other: true, comments: false, strings: true }, editor.wordWrap: on, editor.renderWhitespace: none, editor.tabSize: 2, editor.autoClosingQuotes: always, editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode }, // Markdown 预览设置 markdown.preview.fontSize: 14, markdown.preview.lineHeight: 1.5, markdown.preview.breaks: true, // 换行即 br markdown.preview.linkify: true, // 自动识别链接 markdown.preview.doubleClickToSwitchToEditor: false, // Markdown 扩展设置需安装 yzhang.markdown-all-in-one markdown.extension.toc.levels: 2..4, markdown.extension.toc.unorderedList.marker: -, markdown.extension.preview.autoShowPreviewToSide: true,Makefile[makefile]: { editor.insertSpaces: false, // ★ Makefile 必须用 Tab editor.tabSize: 8 },10. 文件排除与搜索排除// 文件浏览器隐藏 files.exclude: { **/.git: true // **/.vscode: true, // 可选隐藏配置目录 // **/*.exe: true, // 可选隐藏可执行文件 // **/*.o: true // 可选隐藏编译产物 }, // 全局搜索忽略 search.exclude: { **/build: true, // CMake 构建目录 **/node_modules: true, // Node.js 依赖 **/.vscode: true // VSCode 配置目录 },11. 终端与调试// 终端与调试 terminal.integrated.defaultProfile.windows: Command Prompt, // 可改为 Git Bash terminal.integrated.fontSize: 12, debug.console.fontSize: 12, debug.showBreakpointsInOverviewRuler: true, // 滚动条显示断点标记Windows 用户注意如果安装了 Git Bash 或 MSYS2可将defaultProfile.windows改为Git Bash。12. Build TasksCMake Ninja嵌入式项目推荐CMake Ninja组合比 Make 更快且跨平台行为一致tasks: { version: 2.0.0, tasks: [ { label: CMake: 配置 Ninja, type: shell, command: cmake -B build -S . -G Ninja, group: build, problemMatcher: [], detail: 不切换目录生成 Ninja 构建文件 }, { label: CMake: 正常编译, type: shell, command: cmake --build build, group: build, problemMatcher: [], detail: 常规编译不显示完整命令行 }, { label: CMake: 详细编译 显示完整命令行, type: shell, command: ninja -v -C build, group: build, problemMatcher: [], detail: 打印每一条编译链接命令方便排错 }, { label: CMake: 清理工程, type: shell, command: cmake --build build --target clean, group: build, problemMatcher: [] } ] }使用方式CtrlShiftB→ 选择对应 Task或在命令面板CtrlShiftP输入Tasks: Run Task推荐工作流第一步 CMake: 配置 Ninja → 生成 build 目录和构建文件 第二步 CMake: 正常编译 → 增量编译 排错 CMake: 详细编译 → 排查编译错误时使用 重编 CMake: 清理工程 → 全量重编前先清理13. 附完整可复用模板将下面的内容保存为my_project.code-workspace修改其中的路径和宏定义即可用于自己的项目{ folders: [{ path: . }], settings: { // 布局与外观 workbench.colorTheme: Nord, workbench.iconTheme: vs-seti, workbench.startupEditor: none, workbench.editor.enablePreview: false, workbench.tree.renderIndentGuides: always, // 编辑器通用 editor.fontSize: 14, editor.fontFamily: Cascadia Code, Fira Code, Consolas, monospace, editor.tabSize: 4, editor.insertSpaces: true, editor.formatOnSave: true, editor.minimap.enabled: false, editor.fontLigatures: true, editor.detectIndentation: false, // C/C (clangd) C_Cpp.intelliSenseEngine: clangd, clangd.path: clangd, clangd.arguments: [ --background-index, --clang-tidy, --completion-styledetailed, --header-insertioniwyu, ], clangd.fallbackFlags: [ // ← 在此填写你的 -D 宏 和 -I 路径 ], [c]: { editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd, }, [cpp]: { editor.defaultFormatter: llvm-vs-code-extensions.vscode-clangd, }, editor.codeActionsOnSave: { source.fixAll.clang-tidy: always, }, // Python [python]: { editor.tabSize: 4, editor.defaultFormatter: ms-python.black-formatter, }, // 其他语言 [json]: { editor.defaultFormatter: esbenp.prettier-vscode, }, [yaml]: { editor.defaultFormatter: esbenp.prettier-vscode, }, [markdown]: { editor.wordWrap: on, editor.tabSize: 2, editor.defaultFormatter: esbenp.prettier-vscode, }, [makefile]: { editor.insertSpaces: false, editor.tabSize: 8, }, // 排除 files.exclude: { **/.git: true, }, search.exclude: { **/build: true, **/node_modules: true, **/.vscode: true, }, }, tasks: { version: 2.0.0, tasks: [ { label: CMake: 配置, type: shell, command: cmake -B build -S . -G Ninja, group: build, }, { label: CMake: 编译, type: shell, command: cmake --build build, group: build, }, { label: CMake: 清理, type: shell, command: cmake --build build --target clean, group: build, }, ], }, }小结关注点核心配置项外观统一colorTheme、iconTheme、fontFamily编辑器体验enablePreview: false、formatOnSave: trueC/C 智能提示clangd.argumentsclangd.fallbackFlagsPython 格式化ms-python.black-formatter构建自动化tasks中配置 CMake / Ninja 命令工作区隔离files.excludesearch.exclude一步到位将.code-workspace文件放到项目目录终端执行code my_project.code-workspace即可加载全部配置。团队成员只需修改本地的fallbackFlags路径即可无缝协作。文档基于实际 STM32F407 ARM GCC Python 混合项目编写更新时间2026-09-11
