VSCode任务运行器不直接支持部署，需通过tasks.json调用npm、bash等脚本实现；关键在于设"type": "shell"、用"dependsOn"管理依赖、显式配置PATH或启用inheritEnv、使用npx避免全局依赖、分离build与upload任务并用${input:deployTarget}动态指定目标。
VSCode 任务运行器（Task Runner）本身不直接支持“部署”，它只负责执行命令；真正的构建和部署自动化，得靠你把 npm、make、bash 或 python 脚本串起来，再让 tasks.json 去调用它们。
怎么写一个能跑通的 tasks.json
核心是让 tasks.json 正确识别 shell 命令的执行环境和依赖顺序：
- 必须设
"type": "shell"（不是"process"），否则 Windows 上的npm run build可能找不到npm - 如果构建后要上传，用
"dependsOn"把“构建”和“部署”两个 task 关联起来，避免手动触发顺序出错 - Windows 用户注意：默认终端可能是 PowerShell，而很多部署脚本（比如用
scp或rsync）依赖 bash 行为，建议显式指定"group": "build"+"presentation": { "echo": false, "reveal": "silent", "panel": "shared" }并在脚本里用#!/bin/bash头或改用 WSL -
label名必须唯一，且不能含空格（VSCode 会截断），推荐用build:prod这种风格
为什么 npm run deploy 在任务里总报 “command not found”
常见于 macOS/Linux，本质是 VSCode 启动时没加载你的 shell profile（如 ~/.zshrc），导致 PATH 缺失本地安装的 CLI 工具路径：
- 临时解法：在
tasks.json的"options"里补全PATH，例如"env": { "PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}" } - 根治法：在 VSCode 设置里开启
terminal.integrated.inheritEnv（设为true），并确保你从终端启动 VSCode（code .），而不是桌面图标 - 别依赖全局
npm install -g，优先用npx，比如把命令写成npx rsync -av dist/ user@host:/var/www/
如何让部署任务跳过构建，只上传已有的 dist 目录
这是上线热修或 CI 分离场景的刚需，关键在任务定义的灵活性：
- 写两个独立 task：
build和upload:dist，后者不设dependsOn，也不调用构建命令 - 在
upload:dist的"args"里用变量引用当前工作区路径："args": ["-av", "${workspaceFolder}/dist/", "user@host:/path/"] - 如果要用不同目标服务器，别硬编码 host，改用
${input:deployTarget}，并在inputs数组里定义选项列表，VSCode 会弹出选择框 - 加个
"problemMatcher": []防止 rsync 的进度输出被误判为错误
真正卡住人的从来不是语法，而是环境变量、终端类型、权限模型这三块——尤其是当你在 macOS 上用 Homebrew 安装了 rsync，却在 VSCode 里调用系统自带的老版本时，--delete-delay 这种参数直接报错，连日志都看不出 PATH 差在哪。
