VSCode无内置任务命令，所有任务须显式定义于根目录.vscode/tasks.json中；type:"npm"等是插件提供的语法糖，本质调用外部工具，依赖PATH和package.json，type:"typescript"已弃用。
VSCode 没有“内置任务命令”这个概念——它不预装任何可直接运行的构建或测试命令，所有 tasks.json 中的任务都必须显式定义。所谓“内置”，其实是你配置了 type: "npm"、type: "typescript" 等类型后，VSCode 通过插件（如 Node.js Tools、TypeScript 插件）提供的语法糖支持，本质仍是调用外部工具。
为什么 type: "npm" 看起来像内置命令
当你写：
{
"label": "npm-build",
"type": "npm",
"script": "build",
"problemMatcher": ["$tsc"]
}VSCode 并不是在执行某个内部逻辑，而是自动拼出 npm run build 命令并调用 shell 执行。这依赖两个前提：
-
npm必须在系统 PATH 中可执行（VSCode 不加载~/.zshrc或nvm环境） - 当前工作区根目录下必须存在
package.json，且含"scripts": { "build": "..." } - 该
type: "npm"写法只适用于 npm 脚本；换成yarn或pnpm就得改用type: "shell"+ 显式command
注意：type: "npm" 无法传参给脚本（比如 npm run build -- --watch），必须切回 type: "shell"。
type: "typescript" 已被弃用，别再用了
旧文档里提的 type: "typescript" 在 VSCode 1.70+ 版本中已移除。现在统一用：
-
type: "shell"+command: "tsc"（推荐，可控性强） -
command建议写成"npx tsc"或"./node_modules/.bin/tsc"，避免依赖全局安装 - Watch 模式必须配
"isBackground": true和"problemMatcher": "$tsc-watch"，否则任务卡住不退出
错误示例："type": "typescript", "args": ["--watch"] —— 这段配置在最新版 VSCode 中直接被忽略，任务列表里不会出现。
如何让 command 正确找到本地二进制
很多问题源于 VSCode 启动时没继承你的 shell 环境变量。常见失败场景：
-
command: "tsc"报command not found：因为没加载nvm或volta的 PATH -
command: "g++"找不到 MinGW：Windows 下默认不读注册表或环境变量，需绝对路径或加options.env
可靠解法：
- 用
npx或pnpx：例如"command": "npx", "args": ["tsc", "--build"] - 显式指定环境变量：
"options": { "env": { "PATH": "/home/user/.volta/bin:/usr/local/bin:$PATH" } } - Windows 下调用 Git Bash：
"type": "shell", "shell": { "executable": "C:\Program Files\Git\bin\bash.exe", "args": ["-c"] }, "args": ["npx tsc --build"]
多根工作区下 tasks.json 不生效的真相
你在 A 文件夹配好了 .vscode/tasks.json，打开多根工作区后却找不到任务？原因很直接：
- VSCode 只加载「当前焦点文件夹」下的
.vscode/tasks.json - 如果焦点在 B 文件夹，A 文件夹里的 tasks 完全不可见，哪怕路径正确
- 没有跨文件夹继承机制；每个根目录必须单独放一份
.vscode/tasks.json - 检查方法：按
Ctrl+Shift+P→ 输入Tasks: Run Task，看顶部是否显示「[folder-name]」前缀
容易被忽略的一点：VSCode 不会提示“这个文件夹没配任务”，它只是静默跳过——你以为配错了，其实只是焦点不在对应文件夹。
