如何为Visual Studio生成具备完整CMake功能的项目？

问题根源 #

CMake GUI生成的是传统Visual Studio解决方案文件（.sln/.vcxproj），而Visual Studio原生的CMake项目基于Open Folder模式的集成机制，两者底层运行逻辑不同，导致前者无法使用VS针对CMake优化的全套功能。

解决方法 #

1. 切换到VS的Open Folder模式（推荐） #

这是获取完整CMake功能最直接的方式：

• 打开Visual Studio，点击「文件」→「打开」→「文件夹」，选中包含CMakeLists.txt的项目根目录。
• VS会自动识别为CMake项目，加载后就能看到完整的右键上下文菜单，包括「Configure Cache with CMake Debugging」选项，同时会自动生成（或提示生成）CMakePresets.json文件。
• 调试CMakeLists.txt：在目标代码行设置断点，右键文件选择「Configure Cache with CMake Debugging」，按F5即可进入CMake调试会话。

2. 手动添加CMakePresets.json补全基础功能（兼容CMake GUI生成的方案） #

如果必须保留CMake GUI生成的解决方案，可在项目根目录手动创建CMakePresets.json，示例内容如下：

{
  "version": 3,
  "configurePresets": [
    {
      "name": "windows-debug",
      "displayName": "Windows Debug",
      "generator": "Visual Studio 17 2022",
      "architecture": "x64",
      "binaryDir": "${sourceDir}/build/Debug",
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Debug"
      }
    },
    {
      "name": "windows-release",
      "displayName": "Windows Release",
      "generator": "Visual Studio 17 2022",
      "architecture": "x64",
      "binaryDir": "${sourceDir}/build/Release",
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Release"
      }
    }
  ]
}

• 创建后在VS中重新加载解决方案，部分CMake集成功能会恢复，但CMake调试功能仍需依赖Open Folder模式。

3. 检查VS的CMake组件是否完整 #

打开Visual Studio Installer，切换到「修改」界面，在「单个组件」中搜索并勾选「CMake tools for Visual Studio」，安装完成后重启VS，确保所有CMake相关功能模块已加载。

内容的提问来源于stack exchange，提问作者Zebrafish