Windows 环境 VSCode C/C++ 搭建(进阶篇一)

1.概述

VS Code 的 .vscode/ 目录本质上是工作区（workspace）级别的配置目录。里面“能生成/常见会出现”的 .json 文件主要来自：VS Code 本体功能（任务/调试/设置）、以及各类扩展（C/C++、Java、Azure、Docker、Remote 等）写入的配置。下面先给大家有一个概念，后面会针对每一种文件如何进行编写请看进阶篇二。

2.VS Code 核心最常见的 3 个

• settings.json：工作区设置（只对当前项目生效）
  例：格式化、排除文件、终端默认 shell、C/C++ 扩展设置等。

• tasks.json：任务（build/test/run/脚本）配置
  例：CMake build、clang-format、打包脚本。

• launch.json：调试配置
  例：cppdbg/cppvsdbg、node、python 等的启动/附加调试参数。

3.与编辑体验相关（也很常见）

• extensions.json：推荐扩展列表/不推荐列表（团队协作常用）
• keybindings.json：工作区级快捷键（不常见，但支持）
• snippets/*.json：工作区代码片段（注意在 .vscode/snippets/ 子目录下）

4.C/C++ 相关（常见来自微软 C/C++ 扩展）

c_cpp_properties.json：C/C++ IntelliSense 配置（includePath、defines、compilerPath、cStandard/cppStandard 等）
通常在你使用 C/C++ 扩展并创建/选择配置时生成。
备注：如果你用 CMake Tools + clangd，有时会更依赖 compile_commands.json（一般在 build 目录），而不是 c_cpp_properties.json。

5.Multi-root / 工作区文件（不在 .vscode 里，但经常被混淆）

.code-workspace：多根工作区文件（通常放项目根或任意位置），里面也能内嵌 settings/tasks/launch，但它不是 .vscode/.json。

6.其他扩展可能生成的（“可能会有”，取决于你装了什么）

• cmake-kits.json（CMake Tools 旧/特定场景）：记录 kits（编译器/环境）
• docker-compose.json / docker.json（Docker/相关扩展，视扩展而定）
• azure*.json / functions.json 等（Azure/Functions 扩展）
• devcontainer.json（Remote - Containers / Dev Containers）
  严格说它通常在 .devcontainer/devcontainer.json，但有些项目会放在 .vscode（不推荐，但你可能会遇到）。

7.总结：

如果你想要一个“以 C/C++ 开发为主”的最小推荐清单，通常就是这四个：

• .vscode/settings.json
• .vscode/tasks.json
• .vscode/launch.json
• .vscode/c_cpp_properties.json（或改用 clangd + compile_commands）
  你现在的项目是用 CMake Tools、Makefile 还是 纯 gcc/clang 命令？我可以按你的构建方式给一套更推荐的 .vscode/ 文件组合与示例内容。