CMake Tools 扩展可实现 VSCode 中 C++ 项目的高效 CMake 管理：一、安装启用扩展；二、配置工具链与构建目录；三、触发自动配置与构建；四、切换构建类型与目标；五、集成调试与变量查看。
如果您在使用 Visual Studio Code 开发 C++ 项目，但手动配置 CMake 构建流程繁琐且易出错，则可能是由于缺少统一的项目管理界面与自动化构建支持。以下是针对 VSCode 中 CMake Tools 扩展实现高效 CMake 项目管理的具体操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 CMake Tools 扩展
该扩展由 Microsoft 官方维护，提供 CMakeLists.txt 解析、构建目标选择、配置器切换及调试集成能力，是 VSCode 中 CMake 工作流的核心支撑组件。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 CMake Tools，找到作者为 Microsoft 的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
二、配置 CMake 工具链与构建目录
VSCode 需明确识别系统中已安装的 CMake 可执行文件路径及编译器位置，否则无法完成配置阶段；同时指定独立构建目录可避免源码污染并支持多配置并行构建。
1、按下 Cmd+Shift+P（macOS）调出命令面板，输入并选择 CMake: Specify Kit。
2、从列表中选择已检测到的编译器套件（如 Clang 16.0.6 或 GCC 13.2.0），若未列出则需先安装对应编译器并重启 VSCode。
3、再次调出命令面板，输入并选择 CMake: Set Build Directory，输入路径如 build 或 out/debug。
三、触发自动配置与构建流程
CMake Tools 在检测到 CMakeLists.txt 后会自动触发配置（configure）阶段，生成构建系统文件；后续构建操作将基于该配置结果执行，无需手动调用 cmake 命令。
1、确保工作区根目录下存在有效的 CMakeLists.txt 文件，且语法无误。
2、按下 Cmd+Shift+P，输入并选择 CMake: Configure，等待右下角状态栏显示 Configuring done。
3、点击状态栏中的 Build 按钮（或执行 CMake: Build 命令），工具将调用底层构建系统（如 Ninja 或 Make）完成编译。
四、切换构建类型与目标
不同开发阶段需要不同构建类型（如 Debug/RelWithDebInfo/Release）及特定目标（如单元测试、静态库），CMake Tools 提供图形化方式快速切换，避免重复配置。
1、点击 VSCode 窗口底部状态栏中的 [Debug] 字样，弹出构建类型菜单。
2、从中选择所需类型，例如 RelWithDebInfo，系统将自动重新配置并更新构建缓存。
3、再次点击状态栏中当前构建目标名称（如 ALL_BUILD），从下拉列表中选择其他目标，如 test_runner 或 mylib。
五、集成调试与变量查看
CMake Tools 与 VSCode 内置调试器深度协同，能自动识别 CMake 生成的可执行文件路径与符号信息，无需手动编写 launch.json 即可启动调试会话，并支持实时查看 CMake 缓存变量。
1、打开一个 C++ 源文件，在某行左侧空白处点击设置断点。
2、按下 Cmd+Shift+P，输入并选择 CMake: Debug，工具将自动读取 CMakeCache.txt 并定位默认可执行目标。
3、调试启动后，在“变量”面板中展开 CMake Cache 节点，即可查看所有已配置的缓存项（如 CMAKE_BUILD_TYPE、CMAKE_CXX_COMPILER）。
