tasks.json必须放在工作区根目录的.vscode/文件夹下，仅对文件夹工作区生效；单文件打开模式不加载，多根工作区需每个文件夹单独配置，label须为纯ASCII短横线格式且需设"group":"build"才支持Ctrl+Shift+B。
tasks.json 必须放在 .vscode/ 下，且只在文件夹工作区生效
VSCode 不会识别单个文件打开模式下的 tasks.json——你必须用「File → Open Folder」打开整个项目根目录，否则 .vscode/tasks.json 完全不加载，Tasks 菜单始终为空。
路径错误是任务失效的第一原因：
-
.vscode/tasks.json✅（唯一有效位置） -
task.json❌（少个s） -
.vscode/tasks/tasks.json❌（多一层目录） -
src/.vscode/tasks.json❌（子目录里无效） -
~/tasks.json❌（用户家目录不生效）
多根工作区下，每个添加的文件夹都需自带独立的 .vscode/tasks.json；改了非焦点文件夹里的配置，不会反映在当前任务列表中。
label 不能含空格或中文，否则 Ctrl+Shift+B 找不到任务
VSCode 某些版本对 label 的解析很脆弱。写成 "label": "npm build" 或 "label": "运行 Python"，可能导致任务不显示在 Build 菜单里，即使配置语法完全正确。
安全写法是用短横线分隔的纯 ASCII 字符串：
"label": "npm-build""label": "run-python""label": "tsc-watch"
同时，若希望该任务能被 Ctrl+Shift+B 直接触发，必须显式设 "group": "build" 或 "isBuildCommand": true；仅靠 isDefault: true 不够。
command 找不到？不是 PATH 问题，而是 shell 环境没加载
npm run dev 在终端能跑，但在 VSCode 任务里报 command not found，大概率是因为任务进程默认不读取你的 ~/.zshrc 或 nvm 配置，也不自动切换项目级 Node.js 版本。
解决方式分场景：
- macOS/Linux：在
tasks.json中加"options": { "env": { "PATH": "/path/to/node/bin:$PATH" } } - Windows：明确指定 shell 可执行文件，比如
"windows": { "options": { "shell": { "executable": "powershell.exe" } } } - 跨平台稳妥方案：把
command改为绝对路径，如/Users/you/.nvm/versions/node/v20.15.0/bin/npm
别依赖系统自动发现 npm 或 python——VSCode 的任务进程比终端“干净”得多，也更不可信。
tsc --watch 类任务必须配 isBackground 和 problemMatcher
tsc --watch 这类长期运行的任务，在 VSCode 里默认会被当成“已结束”，后续输出（比如新增的编译错误）不会被捕获，F8 也无法跳转到错误行。
要让它真正可用，三个字段缺一不可：
-
"isBackground": true—— 告诉 VSCode 这是个后台持续任务 -
"problemMatcher": "$tsc-watch"—— 注意不是$tsc，这是专为监听模式设计的匹配器 -
"group": "build"（可选但推荐）—— 让它出现在Ctrl+Shift+B列表中
示例片段：
{
"label": "tsc-watch",
"type": "shell",
"command": "tsc",
"args": ["--watch"],
"isBackground": true,
"problemMatcher": "$tsc-watch"
}
另外，--watch 模式不会响应保存自动构建，首次需手动运行一次任务；也没有 runOnSave 这种机制，这是 TypeScript 编译器原生行为，VSCode 只负责包装和解析。
