VSCode tasks.json需显式指定shell路径、用npx避免npm全局依赖、手动注入.env变量、确保文件位置和命名正确、设置dependsOrder为sequence并禁用isBackground以保证串行、配置presentation字段提升错误可见性。
怎么让 VSCode 的 tasks.json 正确运行部署脚本
VSCode 任务不会自动识别你的 shell 环境变量或项目本地的 Node.js 版本，直接写 npm run deploy 很可能报错 command not found 或版本不匹配。
实操建议：
- 在
.vscode/tasks.json中显式指定shell类型和执行路径，比如用"shell": { "executable": "/bin/zsh", "args": ["-c"] } - 避免依赖全局
npm，改用npx或项目内./node_modules/.bin/下的可执行文件，例如"command": "npx --no-install vite build" - 如果部署脚本需要读取
.env，别指望 VSCode 任务自动加载——得手动在env字段里补全，比如"env": { "NODE_ENV": "production", "API_BASE_URL": "https://api.example.com" } - Windows 用户注意：PowerShell 默认禁用脚本执行策略，
deploy.ps1会直接被拒绝，要么改用cmd，要么在任务里加Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（不推荐）
为什么保存后按 Ctrl+Shift+P → “Tasks: Run Task” 找不到你的任务
不是名字没写对，就是 tasks.json 放错了位置——它必须在工作区根目录下的 .vscode/ 文件夹里，且文件名严格为 tasks.json（不能是 task.json 或带空格）。
常见错误现象：
- 任务定义用了
"version": "2.0.0"，但 VSCode 当前版本只认"version": "2.0.0"（没错，这个值是固定字符串，不是语义化版本） - 漏了
"group": "build"或"problemMatcher"，VSCode 就不把它当“可运行任务”，只显示为普通 JSON 对象 - 多个
tasks.json并存（比如根目录一个、子文件夹又一个），VSCode 只读最外层那个
dependsOn 和 dependsOrder 怎么配才真正串行执行
默认情况下，dependsOn 只保证启动顺序，不等上一个任务结束就开下一个——尤其当任务是异步 shell 命令时，部署很可能在构建完成前就开始。
关键点：
- 必须给每个依赖任务加上
"isBackground": false（默认就是 false，但显式写出来更安全） - 如果依赖的是监听类任务（比如
tsc --watch），得配"problemMatcher"并触发"endOfLine"信号，否则 VSCode 认为它永远没结束 -
"dependsOrder": "sequence"是必须项，缺了它即使写了dependsOn，也会并行跑 - 示例片段：
{ "label": "deploy", "dependsOn": ["build"], "dependsOrder": "sequence", "command": "bash ./scripts/deploy.sh", "isBackground": false }
部署失败时，VSCode 终端输出乱码或截断，怎么定位真实错误
VSCode 内置终端默认缓冲区小、不保留完整退出码，且对 ANSI 颜色控制序列处理不稳定，导致错误信息被吞掉或显示为 [31mError[39m 这种。
解决办法很直接：
- 在任务配置里加
"presentation": { "echo": true, "reveal": "always", "panel": "shared", "clear": true }，强制清屏并展开输出 - 把关键命令包装成一行，避免管道符或重定向丢失上下文，比如不用
npm run build 2>&1 | tee build.log，改用npm run build > build.log 2>&1 && cat build.log - 检查
terminal.integrated.env.*设置，某些插件（如 GitLens）会悄悄覆盖PATH，导致找不到ssh或rsync - 真出问题时，别只盯着 VSCode 终端——去系统终端 cd 到同一目录，手动执行
node .vscode/tasks.json里写的那条命令，对比输出
部署逻辑越靠近生产环境，越容易暴露 VSCode 任务和真实 shell 的差异。比如权限、符号链接解析、当前工作目录（cwd 字段不填就默认是工作区根，但脚本里写的是相对 package.json 的路径），这些细节不盯住，一键部署就变成一健报错。
