VS Code 任务配置中的 problemMatcher 如何标记编译错误

如果 VS Code 任务已经在终端打印出编译错误，但 Problems 面板没有任何记录，通常不是编译器没有报错，而是任务系统还不知道怎样拆解这行文本。解决办法是在工作区的 .vscode/tasks.json 中配置 problemMatcher，让正则捕获组分别对应文件、行号、列号、严重级别和消息。

官方文档：https://code.visualstudio.com/docs/debugtest/tasks

先让任务输出变成可匹配的单行格式

先不要急着写复杂正则。把编译器或脚本的诊断输出固定成一种格式，例如：

src/app.c:12:5: error: undefined symbol

这行文字依次包含相对工作区的文件路径、行号、列号、级别和错误消息。真实项目如果输出前后带有时间戳或编译阶段前缀，也建议先确认它们是否稳定，再决定是否写进正则。可匹配的输入比“看起来很灵活”的正则更重要。

在 tasks.json 中把捕获组接到问题字段

按 ⌘⇧P（Windows/Linux 使用 Ctrl+Shift+P）打开命令面板，执行 Tasks: Open Workspace Tasks；也可以在资源管理器中打开 .vscode/tasks.json。将下面的原创示例放入任务数组，并把 command 换成自己的构建命令：

{
  // 中文注释：任务名称会出现在 Terminal > Run Task 的选择列表中。
  "label": "build-diagnostic",
  "type": "shell",
  "command": "make build-with-diagnostics",
  // 中文注释：相对路径以当前工作区为基准，避免文件跳转到错误目录。
  "problemMatcher": {
    "owner": "custom-build",
    "fileLocation": ["relative", "${workspaceFolder}"],
    "pattern": {
      // 中文注释：5 个捕获组依次承接文件、行、列、级别和消息。
      "regexp": "^(.*):(\\d+):(\\d+):\\s+(error|warning|info):\\s+(.*)$",
      "file": 1,
      "line": 2,
      "column": 3,
      "severity": 4,
      "message": 5
    }
  }
}

这里的 fileLocation 必须和输出路径的基准一致。如果编译器打印的是工作区相对路径，就用上面的配置；如果打印绝对路径，可以改成 "absolute"。不要为了让正则“更宽松”而省略行号字段，否则 Problems 面板可能只得到一条不能定位的文本。

运行任务后到 Problems 面板确认结果

保存文件后，依次点击 Terminal > Run Task、选择 build-diagnostic。任务运行时先看终端是否真的出现了约定格式的诊断行，再点击 View > Problems（也可使用快捷键打开问题面板）。正确状态至少应包含以下信息：

点击问题条目后，编辑器应跳转到 src/app.c 第 12 行附近，并在行号栏显示错误标记。这个可点击的定位结果比单看终端更能证明映射正确。

匹配不到时按路径和输出逐项排查

1. 先看任务来源：确认报错确实由 build-diagnostic 输出，而不是另一个终端或后台进程。problem matcher 不会扫描任意面板内容。
2. 再看整行结构：把终端中的一行复制出来，对照冒号数量、空格和级别单词。路径本身含冒号时，正则需要单独设计，不能直接套用示例。
3. 最后看路径基准：Problems 能出现但点击后文件不存在，优先检查 fileLocation、任务的工作目录和实际输出路径。

如果只是想复用 VS Code 已提供的格式，可以把 problemMatcher 写成 "$tsc"、"$eslint-stylish" 等命名匹配器；只有工具输出格式不同，才需要维护自定义正则。背景任务还要额外配置开始和结束模式，不能用普通单次任务的匹配器替代。

常见问题

为什么终端有错误，Problems 面板却是空的？

最常见原因是任务没有绑定 problemMatcher，或者正则没有匹配到完整输出。先确认执行的是配置里的任务，再复制一行真实输出对照捕获组。

必须同时配置 column 和 severity 吗？

不是。能定位到文件和行号就可以生成问题；但如果输出里有列号或级别，保留对应捕获组能让跳转位置和颜色提示更准确。

problemMatcher 能直接读取日志文件吗？

不能直接读取独立日志文件。让任务命令在结束前把需要解析的内容输出到任务终端，再由 matcher 处理。

配置完成后，保留一行稳定的诊断样例作为团队约定。以后编译器升级或脚本改变输出格式时，先用这行样例检查正则，再提交 tasks.json，排错会比盲目修改字段快很多。