如何为Visual Studio 2022 Ninja生成器的CMake项目设置调试工作目录

问题说明 #

用Visual Studio 2022直接打开CMake项目（而非通过生成的.sln文件）时，设置VS_DEBUGGER_WORKING_DIRECTORY目标属性完全无效，仅手动编辑launch.vs.json能修改调试工作目录，但该文件位于.vs目录下（默认被Git忽略），无法提交到仓库，必须从CMake层面完成配置。

可行解决方案 #

方案1：CMake自动生成launch.vs.json #

既然手动修改的launch.vs.json无法纳入版本控制，就用CMake的configure_file命令从模板生成该文件，将工作目录参数化，模板文件可正常提交到仓库。

1. 在项目根目录创建launch.vs.json.in模板文件：

{
  "version": "0.2.1",
  "defaults": {},
  "configurations": [
    {
      "type": "default",
      "project": "CMakeLists.txt",
      "projectTarget": "@TARGET_NAME@.exe",
      "name": "@TARGET_NAME@",
      "workingDirectory": "@DEBUG_WORKING_DIR@"
    }
  ]
}

2. 在CMakeLists.txt中添加配置逻辑，替换模板变量并生成最终文件：

# 按需定义调试工作目录，示例为项目根目录下的bin文件夹
set(DEBUG_WORKING_DIR "${CMAKE_SOURCE_DIR}/bin")

# 替换模板变量，将生成的launch.vs.json放到构建目录
configure_file(
  "${CMAKE_SOURCE_DIR}/launch.vs.json.in"
  "${CMAKE_BINARY_DIR}/launch.vs.json"
  @ONLY
)

每次执行CMake配置时，都会自动在构建目录生成包含指定工作目录的launch.vs.json，VS会自动识别该文件，且模板文件launch.vs.json.in可正常提交到Git仓库。

方案2：设置VS CMake集成专属属性 #

在VS直接打开CMake项目的模式下，可同时设置目标属性与全局属性来生效：

# 为单个目标设置调试工作目录
add_executable(MyApp main.cpp)
set_target_properties(MyApp PROPERTIES
  VS_DEBUGGER_WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}/bin"
  VS_GLOBAL_VS_DEBUGGER_WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}/bin"
)

# 或者全局配置所有目标的调试工作目录
set(CMAKE_VS_DEBUGGER_WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}/bin")
set(CMAKE_VS_GLOBAL_VS_DEBUGGER_WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}/bin")

修改完成后，在VS中执行「CMake > 配置CMake」操作，确保新设置被识别生效。

注意事项 #

• 仅通过生成的.sln文件打开项目时，单纯设置VS_DEBUGGER_WORKING_DIRECTORY才会生效，但这不符合直接打开CMake项目的使用需求。
• 手动编辑的launch.vs.json处于.vs目录，该目录通常被Git忽略，因此通过CMake生成是唯一能将配置同步到仓库的方式。

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