VSCode Tasks需精准配置label、group、isBackground和problemMatcher才能快捷运行；tasks.json必须置于工作区根目录下.vscode文件夹中且命名为tasks.json，type须匹配命令类型，否则任务不可见或静默失败。
VSCode 的 Tasks 不是“配完就能自动跑”，它默认只提供命令触发入口；真正实现快捷，靠的是 label 命名规范、group 分组绑定、以及对 isBackground 和 problemMatcher 的精准控制——否则你点十次 Tasks: Run Task 都找不到那个任务。
tasks.json 放哪？名字写错就彻底失效
VSCode 只读取当前工作区根目录下 .vscode/tasks.json 这一个文件。不是 task.json，不是 .vscode/tasks/tasks.json，也不是子文件夹里的同名文件。常见静默失败现象：任务列表为空、Ctrl+Shift+B 没反应、手动运行 tsc --build 成功但 VSCode 里点不动。
- 必须用「File → Open Folder」打开整个项目文件夹，单文件模式不加载
.vscode/ -
version字段必须是字符串"2.0.0"，写成2.0或"2"都会失效 - 文件名含空格（如
tasks .json）或后缀错误（如tasks.json.bak），VSCode 直接忽略
type: "shell" 还是 type: "npm"？选错影响命令执行和环境变量
用 type: "npm" 能直接复用 package.json 中的 scripts，但只适用于 Node.js 项目，且不继承 shell 环境（比如 nvm 切的 Node 版本、~/.zshrc 里的别名）。用 type: "shell" 更通用，支持管道、变量展开、本地脚本，但需注意 Windows PowerShell 默认策略会拦截 .ps1 脚本。
- 推荐 Node.js 项目优先用
type: "shell"+npx --no-install，例如："command": "npx", "args": ["--no-install", "tsc", "--build"] - 若坚持用
type: "npm"，script字段必须严格匹配package.json中的 key，大小写和空格都不能错 - Windows 用户跑 PowerShell 脚本，必须加
"shell": { "executable": "pwsh", "args": ["-Command"] }，否则被策略拦截
为什么保存后没报错？problemMatcher 缺了就等于没配
VSCode 不解析终端输出，默认把 tsc 或 eslint 的红字当普通文本。没有 problemMatcher，错误不会进 Problems 面板，也不能用 F8 跳转到出错行。
- TypeScript 监听任务必须配
"problemMatcher": "$tsc-watch"，不是"$tsc"（后者只匹配一次性构建） - ESLint 推荐用
"$eslint-stylish"，自定义规则慎写正则，容易漏匹配 - 配了
problemMatcher但没加"isBackground": true？VSCode 会等命令退出才开始捕获输出，--watch类任务永远等不到“退出”，结果就是无错误反馈
怎么让 Ctrl+Shift+B 直接跑你的任务？group 和 label 是关键
Ctrl+Shift+B 默认触发 group: "build" 下的第一个任务。它不看 label 内容，只认 group 值；而 Tasks: Run Task 菜单里显示的名称，完全取决于 label 字段。
- 想让某个任务成为
Ctrl+Shift+B默认项，必须设"group": "build"，且确保它是tasks数组中第一个group: "build"的任务 -
label必须全局唯一，重复会导致菜单只显示一个，但依赖关系里可能悄悄调用另一个，行为不可控 - 多个构建变体（dev/prod）建议用不同
label，如"build:dev"和"build:prod"，避免覆盖
最常被忽略的细节：任务本身不自动触发，首次运行必须手动执行一次；dependsOn 不等于串行，缺 dependsOrder: "sequence" 就是并行；后台任务不配 problemMatcher，等于白搭——这些都不是“试试看”能绕过去的坑。
