VS Code tasks.json 的 problemMatcher 如何让错误可点击

如果 VS Code 的任务只把错误打印在终端里，关键不是给错误文字加链接，而是让 tasks.json 里的 problemMatcher 正确解析文件名、行列位置和消息。配置完成后，错误会进入 Problems 面板，点击条目即可跳到对应代码位置。

官方地址：https://code.visualstudio.com/docs/debugtest/tasks

第一步：从终端菜单打开 tasks.json

先用 VS Code 打开项目文件夹。在顶部菜单选择“终端”→“配置任务”，再选择“创建 tasks.json 文件”或打开已有的 .vscode/tasks.json。如果文件还不存在，选择“其他”生成自定义任务。编辑器中应看到 "version": "2.0.0" 和 "tasks" 数组，这个状态说明入口已经准备好。

这里不要先急着套用别人的正则。先在任务输出中找一行稳定格式，例如 app.js:12:5: error: Unexpected token。文件名、行号、列号和消息的顺序，决定后面捕获组的顺序。

第二步：在 tasks.json 中声明可解析的 problemMatcher

在任务对象中打开“编辑器正文”区域，依次填写 label、type、command 和 problemMatcher。下面的示例假设输出格式是“文件:行:列:级别:消息”；JSONC 的注释是给读者看的，说明每个字段的用途。

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build",
      "type": "shell",
      "command": "npm run build",
      "problemMatcher": {
        "owner": "custom-build",
        "fileLocation": "relative",
        "pattern": {
          "regexp": "^(.+):(\\d+):(\\d+): (error|warning): (.+)$",
          "file": 1,
          "line": 2,
          "column": 3,
          "severity": 4,
          "message": 5
        }
      }
    }
  ]
}

这个配置里，file、line、column、severity 和 message 分别取正则的第 1 到第 5 个捕获组。fileLocation: "relative" 表示 app.js 从当前工作区解析；如果工具输出的是绝对路径，就改用 "absolute"。保存后，编辑器没有红色 JSON 错误提示，且 problemMatcher 字段保持在任务对象内部，就是继续运行的可见信号。

第三步：运行任务并检查 Problems 面板

选择顶部菜单“终端”→“运行任务”，再点击 build。先看底部终端是否出现任务输出，再打开“查看”→“问题”面板。成功解析时，条目至少应有文件名、行号、列号和错误消息；如果只看到终端文本，说明正则没有匹配，或任务没有使用你编辑的那个 problemMatcher。

最常见的偏差有三种：输出使用反斜杠而 fileLocation 按相对路径处理；工具把列号省略而正则仍要求三段位置；级别文本是 ERROR 而表达式只允许小写。先复制一行真实输出对照捕获组，再调整表达式，不要盲目增加通配符。

第四步：点击错误完成反向验证

在“查看”→“问题”面板中点击刚出现的错误条目，观察编辑器是否打开 app.js 并把光标落在第 12 行第 5 列附近。这个跳转结果才是配置有效的最终确认：如果文件能打开但位置偏移，重点检查行列捕获组；如果文件名变成不可识别的路径，重点检查 fileLocation 和任务的工作目录。

常见问题

problemMatcher 一定要自己写吗？

不一定。VS Code 已提供一些内置匹配器，例如 TypeScript 的 $tsc 和 Go 的 $go。只有当工具输出格式不在内置匹配器覆盖范围内，或你需要调整文件路径、级别和消息字段时，才适合写自定义对象。

为什么正则看起来匹配，却仍然不能点击？

通常是只捕获了消息，没有同时提供文件和行列信息。可点击定位至少依赖可解析的文件与位置；先确认问题条目中是否出现文件名和行列，再检查路径是相对工作区还是绝对路径。

配置完成后，保留一行稳定的示例输出作为回归样本。以后任务工具升级，只需重新运行“终端”→“运行任务”并点击 Problems 条目，就能快速判断 problemMatcher 是否仍然有效。