VS Code 任务怎样把编译错误映射到编辑器问题面板

编译任务明明输出了错误，编辑器里的 Problems 面板却是空的，通常不是编译器没有报错，而是 VS Code 不知道怎样从这段文本里找出文件、行号、列号和消息。解决办法是在工作区的 .vscode/tasks.json 中给任务绑定 problemMatcher，让任务输出变成可定位的问题条目。

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

先让编译输出有稳定的错误位置

为了说明映射关系，假设编译器每次发现错误都输出一行固定格式：

src/main.demo:12:8: error: 未声明的变量 total
src/config.demo:5:3: warning: 配置项使用了默认值

这不是某个具体编译器的真实输出，而是教学示例。关键是每行都有“文件:行:列: 级别: 消息”五个部分。只要真实工具能够稳定输出类似结构，就可以用同样的思路写匹配器。

在 tasks.json 里描述错误格式

在工作区根目录建立 .vscode/tasks.json，把编译命令和匹配规则放在同一个任务里。下面的 JSONC 中，owner 用于标记问题来源，file、line、column、severity 和 message 对应正则表达式里的捕获组。

{
  // 任务配置版本由 VS Code 读取，不是编译器版本
  "version": "2.0.0",
  "tasks": [
    {
      "label": "build-demo",
      "type": "shell",
      // 用稳定的示例命令替换成项目自己的编译命令
      "command": "demo-compiler src",
      "problemMatcher": {
        // owner 让 Problems 面板知道问题来自这个任务
        "owner": "demo-build",
        "fileLocation": ["relative", "${workspaceFolder}"],
        "pattern": {
          // 依次捕获文件、行、列、级别和消息
          "regexp": "^(.+):(\\d+):(\\d+):\\s+(error|warning):\\s+(.*)$",
          "file": 1,
          "line": 2,
          "column": 3,
          "severity": 4,
          "message": 5
        }
      }
    }
  ]
}

这里最容易写错的是转义和捕获组编号。正则的第一个括号必须只捕获文件路径，第二、三个括号分别捕获行列；如果在前面又加了一个捕获括号，后面的编号就会整体偏移。像分组但不需要映射的部分，应使用非捕获组 (?:...)。

执行任务后怎样核对 Problems 面板

保存配置后，从 VS Code 的任务入口运行 build-demo。先看任务输出是否仍然包含示例中的文件位置，再打开 Problems 面板。正常情况下，src/main.demo:12:8 会成为一个错误条目，src/config.demo:5:3 会成为一个警告条目；点击条目时，编辑器可以跳到对应位置。

可以用快捷键或命令面板运行任务，也可以直接在任务列表中选择名称。这里的验收重点不是任务是否显示“完成”，而是 Problems 面板中的位置和级别是否与任务输出一致：

空面板或位置错了，按这条顺序排查

第一，确认打开的是工作区。任务支持依赖工作区目录，单独打开某个源文件时，项目里的 .vscode/tasks.json 不会按工作区任务处理。

第二，拿一整行输出去对正则。如果真实输出在级别前多了模块名、颜色控制符或其他前缀，^ 到 $ 的匹配就可能失败。先缩小正则范围，确认文件、行列和消息能被捕获，再逐步加回约束。

第三，检查路径基准。相对文件名要和 fileLocation 一起解释。任务输出写的是相对工作区的路径，就使用 ["relative", "${workspaceFolder}"]；如果编译器输出的是绝对路径，则应按绝对路径语义配置，不要重复拼接工作区目录。

第四，区分任务问题和语言服务问题。Problems 面板可能同时接收任务匹配结果、语言服务诊断和扩展提供的问题。排查时先用独特的 owner 和明显的示例消息确认这条问题确实来自任务。

常见问题

为什么任务完成了但 Problems 面板没有条目？

任务完成只说明命令退出，不代表输出被匹配。先复制一整行编译输出，对照 regexp 的五个捕获组逐段检查。

为什么文件能定位，行号却不对？

通常是正则捕获组编号偏移，或者编译器的行列顺序与配置假设不同。把一行输出中的文件、行、列分别标出来，再确认 file、line、column 指向对应编号。

后台监听任务也能映射问题吗？

可以，但后台任务还要描述何时进入和离开等待状态。先把普通一次性任务的匹配跑通，再增加后台任务的开始、结束模式，避免把两个问题混在一起。

归纳起来，VS Code 任务到 Problems 面板的关键链路只有一条：任务输出提供稳定文本，problemMatcher 用正则提取位置和消息，Problems 面板负责展示与定位。先验收这三段是否一致，通常比反复修改编译命令更快找到原因。