tasks.json必须放在项目根目录的.vscode/tasks.json路径下；vscode仅识别该位置文件，不向上查找或向下扫描，且只对“文件夹工作区”生效。
tasks.json 文件该放在哪里
必须放在项目根目录下的 .vscode/tasks.json 路径，不是随便建个文件夹放进去就能被识别。VSCode 只在工作区根目录的 .vscode/ 子目录里读取这个文件。如果打开的是单个文件（没用文件夹打开），tasks.json 会被忽略——它只对「文件夹工作区」生效。
- 正确路径：
my-project/.vscode/tasks.json - 错误做法：放在
src/下、桌面、或用户全局配置目录里 - 首次创建可按 Ctrl+Shift+P → 输入
Tasks: Configure Task→ 选Create tasks.json file from template，VSCode 会自动建好目录和基础结构
最简可用的 tasks.json 结构长什么样
不用一上来就写一堆 args 或 group，先让一个命令跑起来再说。下面是一个能直接执行 npm run build 的最小合法配置：
{
"version": "2.0.0",
"tasks": [
{
"label": "build",
"type": "shell",
"command": "npm",
"args": ["run", "build"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true
}
}
]
}
-
"type": "shell"表示走系统 shell（Windows 用 cmd/PowerShell，macOS/Linux 用 bash/zsh）；想跨平台更稳可用"type": "process"，但要注意路径分隔符和可执行文件后缀 -
"group": "build"让这个任务出现在「终端 → 运行构建任务」菜单里，不加这行就只能靠命令面板手动搜 -
"panel": "shared"避免每次运行都开新终端面板，复用同一个；换成"dedicated"则每次新建
常见报错：Command not found / 无法识别 npm
典型错误信息是：'npm' is not recognized as an internal or external command（Windows）或 zsh: command not found: npm（macOS）。这不是 VSCode 的 bug，而是 shell 环境没加载你的 Node.js 路径。
- Windows 用户：检查是否安装了 Node.js，并确认
npm在系统 PATH 中（命令行里直接输npm -v能返回版本号才算通） - macOS 用户：如果用 nvm 管理 Node 版本，VSCode 默认启动时不会 source
~/.zshrc，导致找不到npm；解决办法是用终端启动 VSCode：code .，而不是从 Dock 或 Launchpad 点开 - 不想改启动方式？可在
tasks.json里显式指定完整路径，比如"command": "/opt/homebrew/bin/npm"（macOS Homebrew 安装路径）或"command": "C:\Program Files\nodejs\npm.cmd"（Windows）
怎么让 task 自动触发保存时编译
VSCode 本身不支持“保存即运行 task”，但可以用 problemMatcher + isBackground 搭配文件监视器实现近似效果——不过更推荐用 watch 模式本身，比如 TypeScript 的 tsc --watch 或 Webpack 的 webpack serve。
- 先确保 task 是后台型：
"isBackground": true - 加上问题匹配器，例如 TypeScript：
"problemMatcher": "$tsc-watch"（内置），这样错误能实时标在编辑器里 - 别忘了加
"runOptions": { "reevaluateOnRerun": true }，否则修改代码后 Ctrl+Shift+P →Tasks: Rerun Last Task可能不刷新上下文 - 真正省事的做法：用插件如
Auto Run Command或直接在settings.json里配"emeraldwalk.runonsave": {"commands": [{"match": "\.ts$", "cmd": "npm run build"}]}
tasks.json，不如先统一启动方式（终端里开 VSCode），再补全路径或环境变量。
