vscode 的 tasks.json 需配合 problemmatcher（如 "$tsc-watch"）才能将 tsc 错误解析为可跳转报错；启用 isbackground + --watch 实现保存自动构建，但需手动首次运行。
VSCode 的 tasks.json 不是“写完就跑”，它默认不自动触发，必须手动执行或绑定到保存/调试等事件；真正自动化靠的是 runner 和 problemMatcher 的配合，而不是单纯写个命令。
怎么写一个能被 VSCode 识别的编译任务（以 TypeScript 为例）
VSCode 本身不理解 tsc 输出，得靠 problemMatcher 把错误行解析成可跳转的报错。否则终端里一堆红字，但编辑器不会标亮、无法 F8 跳转。
- 在项目根目录建
.vscode/tasks.json，内容模板如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "tsc: build",
"type": "shell",
"command": "tsc",
"args": ["--build"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "silent",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": false
},
"problemMatcher": "$tsc-watch"
}
]
}
-
"problemMatcher": "$tsc-watch"是关键——它复用 VSCode 内置的 TypeScript 匹配规则，能识别error TS2304这类格式；换成"$tsc"也行，但只匹配一次性构建，不支持增量监听 -
"group": "build"让这个任务出现在「运行构建任务」快捷菜单（Ctrl+Shift+B）里 - 别漏掉
"type": "shell"（Windows 上建议用shell而非process，避免 PowerShell 权限或路径问题）
如何让保存文件时自动运行构建（不弹面板、不阻塞编辑）
VSCode 没有“保存即构建”的开关，得靠 runner + isBackground + 后台监听命令组合实现。核心是：任务不能退出，否则 VSCode 认为它结束了。
- 改写 task，启用后台模式：
{
"label": "tsc: watch",
"type": "shell",
"command": "tsc",
"args": ["--watch", "--preserveWatchOutput"],
"isBackground": true,
"problemMatcher": "$tsc-watch",
"group": "build"
}
-
"isBackground": true告诉 VSCode：“这任务会长期运行，别等它结束” -
"--preserveWatchOutput"防止 tsc watch 自动清屏，确保 problemMatcher 能持续捕获新错误 - 再在
settings.json中加一句："task.autoDetect": "on"（启用自动检测） +"files.autoSave": "afterDelay"（配合自动保存） - 但注意：VSCode 不会因为保存就自动触发任务——你得先手动运行一次
tsc: watch，之后它就在后台跑了；保存只是让 tsc 自己响应文件变化
常见报错和卡点：为什么 Ctrl+Shift+B 没反应 / 报错找不到 tsc
不是配置写错了，大概率是环境路径或 Shell 上下文没对上。
- Windows 用户如果装了 Node.js via nvm-windows 或 Scoop，
tsc可能不在系统 PATH 里，VSCode 终端能运行，但 task 默认用 cmd 启动，找不到命令 → 改用"shell": { "executable": "pwsh.exe" }或显式写全路径："command": "npx tsc" - macOS / Linux 下遇到
zsh: command not found: tsc：检查 VSCode 是不是从 Dock 启动（会丢失 shell profile 加载），改用code .从终端启动 - 任务面板显示
Command failed with exit code 2：通常是tsc编译失败（比如语法错），不是配置问题；加"runOptions": { "reevaluateOnRerun": true }可强制重读 tsconfig - 用了
isBackground却没看到输出？确认"presentation.reveal"设为"always"或"silent"，"never"会完全隐藏面板
真正难的不是写 tasks.json，而是让 problemMatcher 稳定匹配不同工具的输出格式——比如 Webpack、Rust 的 cargo build、甚至自定义脚本，每种都要调 pattern 正则；官方内置 matcher 很少，多数得自己写或找社区现成的。
