VS Code任务配置需匹配触发时机与执行上下文，核心问题是环境变量未加载和shell/process类型误用；macOS/Linux用户应启用inheritEnv或显式指定shell路径，type选shell支持多命令串联，process更高效但需正确拆分args，group: "build"和isDefault配合实现Ctrl+Shift+B默认构建。
VS Code 的任务配置不是写个 tasks.json 就能跑通的，关键在「任务触发时机」和「命令执行上下文」是否匹配你的实际构建需求。
为什么 npm run build 在终端能跑，但配置成 task 却报错？
常见现象是提示 command not found: npm 或 Cannot find module，本质是 VS Code 启动时没加载 shell 的环境变量（尤其是 macOS/Linux 的 ~/.zshrc 或 ~/.bash_profile）。
- Windows 用户通常无此问题（PowerShell/cmd 环境较完整）
- macOS/Linux 用户需在 VS Code 设置中启用
terminal.integrated.inheritEnv（设为true） - 更稳妥的做法：在
tasks.json中显式指定shell路径，例如"shell": { "executable": "/bin/zsh", "args": ["-c"] } - 如果项目用 pnpm/yarn，别直接写
npm run build，应统一用pnpm run build或配"group": "build"让 VS Code 识别为构建任务
tasks.json 中 type 填 shell 还是 process？
二者底层调用方式不同：shell 经过系统 shell 解析（支持 &&、|、变量展开），process 是直连二进制执行（更快、更干净，但不支持管道和多命令串联）。
- 需要运行
npm run lint && npm run build→ 必须用"type": "shell" - 只跑单个可执行文件（如
tsc --build或python script.py）→ 推荐"type": "process"，避免 shell 启动开销 -
process模式下，args是字符串数组，不能写成"args": ["--build tsconfig.json"]（会当一个参数传），得拆成["--build", "tsconfig.json"]
如何让 Ctrl+Shift+B 自动匹配当前文件类型的构建命令？
VS Code 不会自动猜你用什么工具构建，必须靠 "group": "build" + "presentation" 配置来绑定默认构建任务。
- 在
tasks.json中给目标 task 加上"group": "build"和"problemMatcher": ["$tsc"]（TypeScript）或["$eslint-stylish"]（ESLint） - 多个 build 任务时，用
"isDefault": true标记一个为默认，否则 Ctrl+Shift+B 会弹出列表让你选 - 想按文件类型切换（比如 .py 文件走
python -m pytest，.ts 文件走tsc），得配多个 task 并手动触发（VS Code 无原生“根据后缀自动选 task”功能） - 可配合插件
multi-command实现快捷键绑定条件逻辑，但已超出原生 task 范围
真正卡住人的往往不是语法，而是环境路径、shell 初始化顺序、以及 VS Code 对“当前工作目录”的判断——它默认用打开的文件夹根目录，但如果开了多根工作区，cwd 可能不是你预期的那个。
