VSCode 的 tasks.json 是命令转发器而非构建工具；需正确配置 label、type、problemMatcher 及文件位置（仅根目录 .vscode/tasks.json 有效），多根工作区需单独配置，编码为 UTF-8 无 BOM，version 必须为 "2.0.0"，shell 类型任务 command 为程序名、args 为参数数组，problemMatcher 不可省略且需匹配输出格式，isBackground 任务需启动信号，保存即构建需配合 watch 模式与手动首次触发。
VSCode 的 tasks.json 不是构建工具，它只是命令转发器；按 Ctrl+Shift+B 能跑起来的前提，是你配对了正确的 label、type 和 problemMatcher，否则终端里只看到命令执行，但错误不进 Problems 面板，也跳不到源码行。
tasks.json 放错位置就完全失效
VSCode 只读工作区根目录下的 .vscode/tasks.json。如果你把它丢进 src/ 或 scripts/ 里，或者文件名写成 task.json、tasks.json.bak，任务列表里压根不会出现任何自定义项。
- 多根工作区下，每个文件夹都要单独配自己的
.vscode/tasks.json，父级配置不继承 - 确保文件编码是 UTF-8，BOM 头会触发 JSON 解析失败（错误信息：
Invalid character in identifier） - 检查
version字段必须是字符串"2.0.0"，不是2.0.0（数字）、"2"或"2.0"
shell 类型任务 command 和 args 容易写反
用 type: "shell" 时，command 是要执行的程序名（如 "npm"、"tsc"、"npx"），所有参数必须拆进 args 数组——不能把整个命令拼成字符串塞进 command 里。
- ❌ 错误写法：
"command": "npm run build -- --watch" - ✅ 正确写法：
"command": "npm", "args": ["run", "build", "--", "--watch"] - 调用本地二进制时优先用
npx或./node_modules/.bin/tsc，避免依赖全局安装版本 - 如果命令含管道或重定向（如
ls | grep .ts），得显式调用 shell："shell": { "executable": "/bin/bash", "args": ["-c"] }，再把完整命令放args里
problemMatcher 不配或配错，错误就“看不见”
problemMatcher 不是可选项，它是让 VSCode 把终端输出里的报错解析成可点击跳转条目的关键。没它，tsc 报了 error TS2307，你只能手动翻日志找文件和行号。
- TS 项目直接用
"problemMatcher": "$tsc"（注意带引号，是字符串） - Watch 模式用
"$tsc-watch"，但必须搭配"isBackground": true，否则任务卡在“正在运行”状态 - 自定义命令需手写正则，例如匹配
main.ts(5,10): error TS2304: Cannot find name 'xxx'.，pattern 至少得捕获file、line、column、message四个组，顺序不能错 - 输出里若含 ANSI 颜色码（如
\u001b[31m），可能干扰正则匹配，可在presentation中加"echo": false, "reveal": "always"减少干扰
想保存自动构建？tasks.json 本身做不到
VSCode 的任务系统默认是手动触发的。所谓“保存即构建”，其实是靠两个配合：isBackground: true + 构建工具自身的 watch 模式（如 tsc --watch、vite build --watch），再配合文件保存事件绑定。
- 必须手动先运行一次任务（Ctrl+Shift+B），启动后台进程；后续保存不会自动再触发
- 要真自动化，得用扩展如
Auto Run Command或改用tasks.json+launch.json联动，但那是另一层机制 - 多个依赖任务（如
clean→build）要用"dependsOn": ["clean"]+"dependsOrder": "sequence"，否则并行执行可能出错 -
isBackground: true的任务，必须输出启动完成信号（如Starting compilation...），否则 VSCode 会一直显示“正在运行”，无法响应后续操作
最常被忽略的一点：任务能跑通 ≠ 错误能定位。很多团队配好了 command 和 args 就以为完事，结果开发时遇到 TS 编译错误，还得切到终端一行行翻——问题就出在 problemMatcher 没生效，或者正则根本没匹配上实际输出格式。
