VS Code C/C++扩展按F5调试报错：找不到'C/C++: gcc build active file'任务

问题原因 #

报错的核心是调试启动时默认关联的构建任务名称，和你tasks.json中已有的构建任务label不匹配：默认调试配置找的是名为C/C++: gcc build active file的任务，但你现有的构建任务是clang编译的C/C++: clang build active file，因此无法匹配。

解决方案 #

方案1：切换为gcc编译（快速匹配报错的任务名） #

如果你打算使用gcc作为编译器，直接修改tasks.json的对应参数即可：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc build active file",
            "command": "/usr/bin/gcc",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "compiler: /usr/bin/gcc"
        }
    ]
}

修改完成后按F5即可正常启动调试。

方案2：保留clang编译（配置对应launch.json） #

如果你要继续使用clang作为编译器，按以下步骤操作：

• 打开待调试的C/C++文件，点击左侧「运行和调试」面板，选择「创建launch.json文件」
• 在弹出的选项中依次选择「C++(GDB/LLDB)」→「clang - 生成和调试活动文件」
• 生成的launch.json会自动匹配你现有tasks.json的构建任务，无需额外修改，按F5即可启动调试

如果需要手动编写launch.json，可参考以下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "clang - 调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "lldb",
            "preLaunchTask": "C/C++: clang build active file"
        }
    ]
}

注意事项 #

launch.json中的preLaunchTask参数值必须和tasks.json中的label参数值完全一致，大小写、空格、标点都不能有差异，否则仍会触发找不到任务的报错。

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