如何在VS Code中配置带命令行参数的C++程序调试？

可直接使用的launch.json示例 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 启动调试",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/${fileBasenameNoExtension}",
            "args": ["test.txt", "1024", "sample output"],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "gdb",
            "setupCommands": [
                {
                    "description": "启用gdb美观打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "设置反汇编风格为Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++ 生成活动文件"
        }
    ]
}

核心配置项说明 #

• program：指定编译后的可执行文件路径
  • ${workspaceFolder}：当前VS Code工作区根目录
  • ${fileBasenameNoExtension}：当前编辑的代码文件名（不含后缀），比如main.cpp对应main
  • 如果编译文件放在build子目录，修改为${workspaceFolder}/build/${fileBasenameNoExtension}即可
• args：命令行参数数组，每个参数单独作为一个元素，带空格的参数直接写字符串，比如["hello world", "input.dat"]
• miDebuggerPath：gdb的路径
  • Windows：若MinGW已加环境变量，填gdb.exe；否则填完整路径，比如D:/MinGW/bin/gdb.exe
  • Linux/macOS：直接填gdb（已安装且在环境变量中），或完整路径如/usr/bin/gdb
• preLaunchTask：必须与tasks.json中的编译任务名称完全一致，确保调试前自动编译最新代码
• externalConsole：设为true会弹出独立控制台，方便交互输入；false则使用VS Code内置终端

常见问题解决 #

• 提示找不到可执行文件：检查program路径是否和编译产物实际位置匹配，确认preLaunchTask能正常完成编译
• 参数不生效：检查args数组格式，确保没有语法错误（比如多余逗号、引号不配对）
• gdb路径错误：在终端执行gdb --version，能正常输出则直接填gdb（或gdb.exe），否则找实际安装路径填入

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