vs code 任务配置必须严格遵循规范：tasks.json须置于项目根目录.vscode/下；label禁用空格中文；version须为字符串；多根工作区仅激活文件夹配置；tsc--watch需isbackground:true和problemmatcher:"$tsc-watch"；npm命令推荐npx或本地二进制路径；dependson需配合dependsorder:"sequence"且后台任务不可直接依赖。
tasks.json 必须放在项目根目录的 .vscode/tasks.json，否则 VS Code 根本不加载——不是“不生效”，是彻底看不见。
任务为啥在 Tasks: Run Task 里找不到
不是 VS Code 没刷新，而是配置没被识别为合法任务。高频原因包括：
-
label含空格或中文（如"npm build"），某些版本解析失败；改用"npm-build" - 漏了
"group": "build"或"isBuildCommand": true——Ctrl+Shift+B只认group: "build" -
version写成"2.0"或2.0.0（没加引号）；必须是字符串"2.0.0" - 多根工作区下，改的是非焦点文件夹里的
tasks.json；只有当前活动文件夹的配置起作用 - 用 “Open File” 打开单个文件，而非 “Open Folder”；
.vscode/下所有配置都不加载
tsc --watch 不报错也不跳转到错误行
VS Code 默认把 tsc --watch 当作普通前台命令，输出只是文本流，不解析、不定位。要让它真正“活”起来，必须同时满足：
-
"isBackground": true：告诉 VS Code “这任务不会退出，持续监听” -
"problemMatcher": "$tsc-watch"：不是$tsc（那是给一次性构建用的） - 首次需手动运行一次任务：保存文件不会自动触发，VS Code 原生不支持
runOnSave
示例关键字段：
{
"label": "tsc-watch",
"type": "shell",
"command": "tsc",
"args": ["--watch"],
"isBackground": true,
"problemMatcher": "$tsc-watch"
}
npm run build 报 command not found 怎么办
VS Code 的任务进程默认不加载你的 shell 配置（如 ~/.zshrc），也不继承项目级 Node.js 版本（比如 nvm 或 volta 管理的版本）。直接写 "command": "npm" 很可能找不到命令，或调用到系统全局旧版 Node。
- 推荐用
"command": "npx"+"args": ["--no-install", "tsc", "--build"] - 或直接指向本地二进制：
"command": "./node_modules/.bin/tsc"，避免依赖全局安装 - 需要环境变量时，必须显式补全
"env"字段，例如"env": { "NODE_ENV": "development" } - Windows 用户若用 PowerShell，建议加
"shell": { "executable": "pwsh", "args": ["-Command"] }，否则脚本常被策略拦截
dependsOn 任务顺序乱、后续任务提前执行
dependsOn 默认只控制启动顺序，不等前一个结束就开下一个。尤其当依赖项是 tsc --watch 或 webpack serve 这类长期运行的任务时，后续部署任务大概率在构建完成前就冲进去了。
- 必须加
"dependsOrder": "sequence"，否则依赖只是“并行启动” - 被依赖任务不能设
"isBackground": true（否则 VS Code 认为它“永远没结束”，后续任务卡住） - 如果前置任务本身是后台监听型（如 dev server），应拆分为两个任务：一个纯构建（
isBackground: false），一个单独启服务（isBackground: true），再让部署任务依赖前者
真正容易被忽略的点是：isBackground 和 dependsOrder 必须配合使用，单靠 dependsOn 字符串数组毫无顺序保障。
