VSCode任务本质是命令调度器而非构建工具；必须将tasks.json置于工作区根目录.vscode/下且version为"2.0.0"，command仅填可执行文件名、参数放入args，后台任务须isBackground与problemMatcher成对使用。
VSCode 的 Task Runner 不是开箱即用的“自动构建开关”，它本质是个命令调度器，能不能自动化，取决于你有没有配对好 isBackground 和 problemMatcher，以及 tasks.json 是否放在对的位置。
tasks.json 放哪儿才生效
VSCode 只认工作区根目录下的 .vscode/tasks.json —— 多一个点、少一个点、进错文件夹，任务就彻底消失。
- ❌ 错误路径：
src/.vscode/tasks.json、.vscode/tasks.json.bak、myproject/tasks.json - ✅ 正确路径：
myproject/.vscode/tasks.json（注意.vscode是隐藏文件夹） - 多根工作区？每个根目录都要单独配一份，不继承、不合并
- 改完文件不用重启 VSCode，但要按
Ctrl+Shift+P→ 输入Tasks: Run Task刷新缓存，否则旧任务还在列表里
type: "shell" 还是 type: "process"
选错类型，轻则命令找不到，重则卡死在“正在运行任务…”状态。
-
type: "shell"：走系统 shell（Windows 是cmd.exe或powershell，macOS/Linux 是bash），支持&&、|、环境变量展开，适合npm run build、tsc --watch这类带逻辑的命令 -
type: "process"：直接调用二进制，不经过 shell，启动快，但不支持管道或$PATH自动查找；比如想跑tsc，就得确保它在全局 PATH 里，Windows 下还得写成tsc.cmd - Windows 用户注意：
type: "shell"默认用cmd，不识别export NODE_ENV=dev；要用 PowerShell 得加"options": {"shell": {"executable": "pwsh"}}
tsc --watch 为啥不报错也不跳转
因为 VSCode 默认把它当普通前台命令执行，输出只是文本，不是“问题”。必须显式告诉它：“这是个后台监听任务，这些红字是错误，请解析。”
- 缺
"isBackground": true→ VSCode 等不到退出信号，一直卡在“正在运行任务…” - 缺
"problemMatcher": "$tsc-watch"→ 红字不会进 Problems 面板，F8 跳转失效；别用"$tsc"，那是给一次性构建用的 - 首次必须手动运行一次任务（
Ctrl+Shift+P→Tasks: Run Task），VSCode 原生不支持“保存即触发” - 想真正在保存时构建，得靠
"files.autoSave": "onFocusChange"+ 手动绑定为默认构建任务（Ctrl+Shift+B）+ 外部扩展（如 Save and Run）补足
npm run build 总报 command not found
不是 npm 没装，是 VSCode 启动时没加载你的 shell 配置（比如 ~/.zshrc），PATH 里压根没有本地 Node 或 npm 路径。
- 临时解法：在 task 的
"options"里硬写 PATH，例如"env": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"} - 根治法：VSCode 设置里打开
terminal.integrated.inheritEnv（设为true），并确保你是从终端执行code .启动的，而不是双击图标 - 更稳做法：别依赖全局
npm install -g，改用npx tsc --build或npx webpack，npx 会自动找项目级依赖 -
"command": "npm"是错的，正确写法是"command": "npm"+"args": ["run", "build"]；command只能填可执行文件名，参数全塞args
真正卡住人的从来不是 JSON 语法，而是环境变量是否继承、shell 类型是否匹配、isBackground 和 problemMatcher 是否成对出现——这三者漏掉任意一个，任务就只是“看起来在跑”，实际既不构建，也不报错，更不跳转。
