VS Code中$gcc问题匹配器无法显示全部错误与警告的解决办法

问题描述 #

基于CMake的VS Code C项目，使用gcc编译，自定义构建任务指定$gcc作为problemMatcher，但存在以下问题：

• 编译错误/警告无法全部显示，通常仅展示第一条，偶尔显示两三条
• 若警告在错误前出现，仅显示该警告，后续错误完全被忽略
• 问题呈间歇性，重启VS Code可暂时恢复正常
• 已将VS Code（1.92.1）、C++扩展（v1.21.6）、CMake Tools（1.18.44）更新至最新版本，问题仍未解决

稳定复现步骤 #

• 全新启动VS Code并打开工作区
• 添加产生警告的代码（如未使用的变量）
• 注释多个函数定义，触发12个gcc错误
• 首次构建时，VS Code能显示全部12个错误与警告
• 重复构建约20次后，错误数量逐渐减少；40次后仅显示5个，最终可能只剩1个

当前tasks.json配置 #

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cmake",
            "label": "CMake: build application",
            "command": "build",
            "presentation": {
                "echo": false,
                "reveal": "always",
                "focus": false,
                "close": false,
                "panel": "dedicated",
                "revealProblems": "onProblem",
                "showReuseMessage": false,
                "clear": true
            },
            "targets": [
                "all"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "CMake build task",
            "problemMatcher": ["$gcc"]
        }
    ]
}

解决方案 #

1. 自定义gcc问题匹配器，覆盖默认配置 #

默认$gcc匹配器可能存在缓存或匹配逻辑缺陷，自定义规则可明确捕获所有错误/警告，同时强制清空历史问题：

"problemMatcher": [
    {
        "base": "$gcc",
        "owner": "cpp",
        "fileLocation": "absolute",
        "applyTo": "allDocuments",
        "pattern": {
            "regexp": "^(.*?):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$",
            "file": 1,
            "line": 2,
            "column": 3,
            "severity": 4,
            "message": 5
        },
        "clear": true
    }
]

• clear: true：每次构建前清空历史问题列表，避免累积导致的匹配异常
• 显式正则匹配模式：确保gcc所有错误/警告输出都能被精准捕获

2. 强制gcc输出完整错误信息 #

在CMakeLists.txt中添加编译选项，让gcc遇到错误后继续编译，输出所有错误：

set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wfatal-errors=0")

-Wfatal-errors=0 取消默认的"遇到第一个错误即停止编译"行为，确保所有错误都能输出。

3. 禁用CMake增量构建缓存 #

CMake Tools的增量缓存可能导致输出不完整，修改tasks.json强制每次构建前清理：

{
    "type": "cmake",
    "label": "CMake: build application",
    "command": "build",
    "cmake": {
        "buildArgs": ["--clean-first"]
    },
    // 其他原有配置...
}

4. 改用Shell任务直接调用CMake #

避免使用type: "cmake"任务类型的潜在问题，改用Shell任务直接执行构建命令：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "CMake: build application",
            "type": "shell",
            "command": "cmake --build ${workspaceFolder}/build --target all",
            "presentation": {
                "echo": false,
                "reveal": "always",
                "focus": false,
                "close": false,
                "panel": "dedicated",
                "revealProblems": "onProblem",
                "showReuseMessage": false,
                "clear": true
            },
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "CMake build task",
            "problemMatcher": [
                {
                    "base": "$gcc",
                    "clear": true
                }
            ]
        }
    ]
}

5. 清理VS Code任务缓存 #

打开命令面板（Ctrl+Shift+P），执行 Tasks: Clear Task Cache，清空VS Code内部的任务输出缓存。

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