VSCode中CMake Tools如何为不同启动目标配置专属启动参数

针对VSCode搭配CMake Tools时，不同可执行目标需要适配不同调试参数的场景，可通过以下三种方案实现，无额外依赖：

方案一：为每个目标编写独立的launch配置条目 #

这是兼容性最好的原生实现方式，不受CMake Tools版本限制：

• 在launch.json的configurations数组中，为每个需要调试的可执行目标新增单独的配置项
• 每个配置项中直接定义对应目标的可执行文件路径、专属启动参数、工作目录等信息

参考配置示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "调试串口工具程序",
      "type": "cppdbg",
      "request": "launch",
      "program": "${command:cmake.buildDirectory}/build/bin/serial_tool",
      "args": ["--serialPort", "/dev/ttyS0"],
      "stopAtEntry": false,
      "cwd": "${command:cmake.buildDirectory}/build/bin",
      "externalConsole": false,
      "MIMode": "gdb",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    },
    {
      "name": "调试数据解析程序",
      "type": "cppdbg",
      "request": "launch",
      "program": "${command:cmake.buildDirectory}/build/bin/data_parser",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${command:cmake.buildDirectory}/build/bin",
      "externalConsole": false,
      "MIMode": "gdb",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ]
    }
  ]
}

使用时直接在调试面板的下拉选择器中，选中对应目标的配置项按下F5即可启动，完全不需要依赖CMake Tools选中的全局启动目标，不存在参数错配的问题。

方案二：通过CMake目标属性绑定专属调试参数 #

如果习惯沿用CMake Tools「选中启动目标自动匹配配置」的交互逻辑，可在CMakeLists.txt中给每个可执行目标绑定专属调试参数，CMake Tools扩展会自动把参数注入通用调试配置：

• 在定义可执行目标的位置，通过set_target_properties给目标附加VSCODE_DEBUGGER_ADDITIONAL_ARGS属性，值为该目标调试时需要传入的参数列表（参数间用分号分隔）

参考示例：

# 构建串口工具目标
add_executable(serial_tool src/serial_tool.cpp)
# 绑定该目标的专属调试参数
set_target_properties(serial_tool PROPERTIES
  VSCODE_DEBUGGER_ADDITIONAL_ARGS "--serialPort;/dev/ttyS0"
)

# 构建数据解析目标
add_executable(data_parser src/data_parser.cpp)
# 该目标不需要额外参数则无需设置属性

配置完成后，原有的通用launch配置（使用${command:cmake.launchTargetPath}获取选中目标路径的配置）无需修改，切换CMake Tools选中的启动目标时，对应的参数会自动匹配加载。
注意：该特性需要CMake Tools扩展版本在1.10及以上才支持。

方案三：临时参数快速调整 #

如果需要对同一个目标临时传入不同的参数，不需要改动配置文件，可在启动调试前，在VSCode调试面板的「参数」输入栏直接修改临时参数，调整后的值会自动临时保存在当前调试配置中，下次启动直接生效。

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