VSCode tasks.json需置于项目根目录的.vscode/tasks.json中且为数组格式，version必须为"2.0.0"，label唯一，type推荐"shell"，command与args分离，PATH问题需通过绝对路径或env配置解决，监听依赖工具原生watch并配合isBackground和problemMatcher。
VSCode 的 tasks 系统本身不执行构建或脚本，它只是把命令交给 shell 或终端去跑——配置错的地方，90% 是路径、工作目录或 shell 解析逻辑没对齐。
怎么写一个能跑起来的 tasks.json
必须放在项目根目录的 .vscode/tasks.json 下，且顶层是数组（不是对象）。VSCode 6.0+ 要求 version 字段为 "2.0.0"，否则直接忽略整个文件。
-
label是你在「运行任务」列表里看到的名字，必须唯一，建议用短小动词+工具名，比如"build:ts"或"test:jest" -
type填"shell"（推荐）或"process"；前者走系统 shell（支持&&、|），后者绕过 shell，适合纯二进制调用但不支持管道 -
command是实际执行的命令，可以是 npm 脚本名（如"npm"）、可执行文件路径（如"./scripts/deploy.sh"），或直接写"tsc --build" -
args是参数数组，不要把参数拼在command里；例如tsc --build tsconfig.prod.json应拆成"command": "tsc"+"args": ["--build", "tsconfig.prod.json"]
为什么 npm run dev 在终端能跑，任务里却报 command not found
常见于 macOS/Linux 使用 zsh、Windows 使用 PowerShell 的环境：VSCode 默认启动的是非登录 shell，不会加载 ~/.zshrc 或 $PROFILE，导致 npm、node、pnpm 找不到。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 检查方式：在任务里加一行
"echo $PATH"，对比终端里echo $PATH输出是否一致 - 临时解法：把
command改成绝对路径，比如"/usr/local/bin/npm"（用which npm查） - 长期解法：在
tasks.json中加"options": { "env": { "PATH": "/usr/local/bin:/opt/homebrew/bin:..." } }，或改用"type": "shell"并在command前显式 source，如"command": "source ~/.zshrc && npm run dev"（注意 Windows 不支持source）
如何让任务自动监听文件变化并热重载
VSCode 任务本身不提供监听能力，得靠工具自身支持（如 tsc --watch、nodemon、webpack serve），再配合 isBackground 和 problemMatcher 让 VSCode 识别输出、停止/重启任务。
- 加
"isBackground": true，否则任务一启动就卡住 UI - 必须配
"problemMatcher"，否则 VSCode 不知道任务“已启动成功”，会一直显示“正在启动…”；常用值："$tsc-watch"（TypeScript）、"$eslint-stylish"（ESLint）、或自定义正则匹配启动日志，比如{"owner": "custom", "pattern": {"regexp": "Compiled successfully", "file": 1}} - 别用
chokidar-cli或onchange包裹命令——它们输出不稳定，problemMatcher很难对齐，优先选原生 watch 模式
真正容易被忽略的是工作目录（cwd）：如果没显式指定，任务默认在打开的文件夹根目录运行，但你的 package.json 或 tsconfig.json 可能在子目录里。一旦报错找不到配置，第一反应不该是重装依赖，而是加一句 "cwd": "${workspaceFolder}/packages/core"。
