VSCode多命令行参数调试配置问题及launch与tasks.json区别

一、先搞懂launch.json和tasks.json的区别 #

• tasks.json：负责构建项目，把终端里的编译/链接命令（比如make、g++）集成到VSCode，告诉编辑器怎么生成可执行文件。
• launch.json：负责启动调试器（gdb），告诉编辑器要调试哪个可执行文件、传什么参数、调试时的工作目录等。

二、解决'executableName not found'的核心方案 #

你的问题根源是tasks.json的构建逻辑和老师的Makefile不匹配，加上launch.json的工作目录配置错误，具体修改步骤如下：

1. 替换tasks.json，调用Makefile构建 #

把原有的tasks.json换成下面的内容，让VSCode直接执行老师写的make命令，完全复用项目的构建逻辑：

{
    "tasks": [
        {
            "label": "Make Build",
            "type": "shell",
            "command": "make",
            "args": [],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "调用项目Makefile构建可执行文件"
        },
        {
            "label": "Make Clean",
            "type": "shell",
            "command": "make clean",
            "args": [],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "detail": "清理构建产物"
        }
    ],
    "version": "2.0.0"
}

原tasks.json是单文件编译逻辑，而你的项目是多文件链接生成可执行文件，必须用Makefile的规则构建，否则生成的文件要么缺失依赖，要么路径不对。

2. 修改launch.json，匹配项目路径和工作目录 #

调整launch.json的工作目录，并添加调试前自动构建的配置，确保可执行文件可用且能读取到dat目录下的文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/test-find-sum",
            "args": ["dat/row_matrix.txt", "1"],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}", // 改成项目根目录，确保能找到dat文件夹
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "preLaunchTask": "Make Build", // 调试前自动执行构建，保证可执行文件是最新的
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description":  "Set Disassembly Flavor to Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

关键修改点：

• cwd设为${workspaceFolder}：程序要读取dat/目录下的文件，必须从项目根目录启动，否则会找不到文件。
• 新增preLaunchTask：调试前自动执行构建，避免代码修改后未重新编译导致的错误。

三、正确调试步骤 #

1. 确保VSCode打开的是项目根目录（包含Makefile、src、inc、dat的文件夹），不是单个文件。
2. 按Ctrl+Shift+B执行Make Build任务，生成test-find-sum可执行文件。
3. 打开要调试的源文件（比如src/test_find_sum.cpp），点击行号左侧设置断点。
4. 按F5启动调试，VSCode会自动完成构建并启动gdb，同时传入你配置的命令行参数。

四、常见问题排查 #

• 若仍提示可执行文件不存在：先在终端手动执行make，看是否能生成test-find-sum，如果终端也失败，说明是Makefile的环境问题，找老师确认。
• 若提示"文件未找到"（指dat下的文件）：检查cwd是否设为项目根目录，或者在终端手动运行./test-find-sum dat/row_matrix.txt 1，确认文件路径是否正确。
• 若提示"文件格式不支持"：确认Makefile里加了-g参数（老师的Makefile已经包含flags += -g），确保可执行文件带调试信息。

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