VSCode中tasks.json的command不写死路径时，直接写"node"或"pnpm"会因非交互式shell不加载shell配置导致command not found；正确做法是显式设"type": "shell"并以字符串形式写完整命令如"pnpm run dev"，确保环境变量、nvm及本地bin路径生效。
tasks.json 里 command 不写死路径，改用 shell 类型任务
直接写 "command": "node" 或 "command": "pnpm" 在不同终端下大概率失败，因为 VSCode 默认用非交互式 shell（如 /bin/sh 或 cmd.exe），不加载你的 ~/.zshrc、NVM_BIN 或 Windows 的 PATH 扩展。macOS 上 zsh 能跑的命令，任务里报 command not found 就是这个原因。
正确做法是把 "type": "shell" 显式加上，再把整条命令写成字符串：
{
"label": "run dev",
"type": "shell",
"command": "pnpm run dev",
"group": "build"
}
这样 VSCode 就会调用你当前默认终端（比如 zsh 或 pwsh）去执行，环境变量、nvm、本地 node_modules/.bin 全部生效。注意："command" 此时是完整命令行字符串，不是可执行文件名。
Windows 上避免 cmd，优先指定 PowerShell 或 Git Bash
Windows 默认终端是 cmd.exe，它不支持 npx、export、路径展开等现代脚本特性，且对空格路径处理极差。哪怕你在 settings.json 里配了 Git Bash，任务仍可能走 cmd——因为 tasks.json 默认不继承终端 profile。
解决方案是两种之一：
- 在
tasks.json中显式指定 shell："options": { "shell": { "executable": "pwsh" } }（需已安装 PowerShell Core）或"executable": "C:\Program Files\Git\bin\bash.exe" - 全局改默认终端为 PowerShell/Git Bash，并确保
terminal.integrated.inheritEnv为true，让任务间接继承环境
别信“cmd 能跑 npm 就没问题”——一旦脚本里有 $(npm bin) 或 source .env 这类操作，cmd 立刻崩。
args 传参必须拆成数组，尤其含空格路径时
"args": ["--entry", "src/main.ts"] ✅ 正确；"args": ["--entry src/main.ts"] ❌ 错误。后者会被当做一个参数传给命令，TypeScript 编译器收不到 --entry 开关，直接报错。
更麻烦的是路径含空格，比如 "src/my app/index.ts"。不要试图手动加引号："args": ["--entry", ""src/my app/index.ts""] 是错的（JSON 字符串里双引号要转义，且 shell 层可能多解一层）。稳妥做法只有两个：
- 用
"type": "shell"，把整个命令写成字符串："command": "tsc --entry "src/my app/index.ts"" - 彻底避免空格：项目路径别用中文或空格，这是最省心的兼容方案
跨平台任务别依赖 shell 内置命令
写 "command": "rm -rf dist" 在 macOS/Linux 没问题，但 Windows 的 cmd 和 PowerShell 都不认识 rm。同理，mkdir -p、cp -r、sed -i 全部跨平台不安全。
实际能用的方案只有三个：
- 用 Node.js 脚本封装（
rimraf dist、fs.rmSync），然后"command": "node ./scripts/clean.js" - 用 cross-env + npm script，比如
"clean": "rimraf dist"，任务里调"command": "npm run clean" - PowerShell 命令（
Remove-Item -Recurse -Force dist）只限 Windows，得配合"options": { "shell": { "executable": "pwsh" } }使用
没有银弹。所谓“兼容不同版本终端”，本质是放弃对 shell 命令的幻想，把逻辑下沉到语言层或包管理器层。
