VSCode任务报“command not found”本质是PATH缺失：macOS/Linux因桌面启动未加载~/.zshrc导致Homebrew工具路径丢失，Windows因PowerShell不兼容bash语法或未继承用户PATH；须设"type":"shell"、补全PATH或改用npx。
VSCode 任务运行器本身不支持“部署”这个动作，它只负责执行命令；真正能部署的，是你写在 tasks.json 里的脚本、npx 调用或 scp/rsync 命令——关键在于环境通、路径对、依赖明。
为什么 npm run deploy 在任务里总报 “command not found”
本质是 VSCode 启动时没加载你的 shell 配置（比如 ~/.zshrc），导致 PATH 缺失本地 CLI 工具路径：
- macOS/Linux 用户常见于用 Homebrew 安装了
rsync或ssh，但 VSCode 桌面图标启动时不继承终端环境 - Windows 用户若默认终端是 PowerShell，而脚本依赖 bash 特性（如
[[判断、$(...)替换），会直接失败 - 临时解法：在
tasks.json的"options"里硬补PATH，例如"env": { "PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}" } - 根治法：VSCode 设置中开启
terminal.integrated.inheritEnv（设为true），并确保从终端执行code .启动编辑器 - 更稳妥的做法：别依赖全局安装，改用
npx rsync或npx ssh，避免环境差异
type: "shell" 和 type: "process" 的区别必须分清
Windows 上尤其容易踩坑：type: "process" 会绕过 shell 解析，导致 npm、make 等命令找不到：
-
"type": "shell"→ 走系统默认 shell（macOS/Linux 是 zsh/bash，Windows 默认是 PowerShell） -
"type": "process"→ 直接 fork 进程执行二进制，不经过 shell，npm run build这种带空格的命令会解析失败 - 如果你的部署脚本含管道
|、重定向>、条件判断&&，必须用"type": "shell" - Windows 用户若脚本依赖
rsync或ssh，建议显式指定终端为bash（启用 WSL）或在脚本开头加#!/bin/bash
如何让部署任务跳过构建，只上传已有 dist 目录
这是热修、CI 分离或本地验证的刚需，核心是任务解耦和变量引用：
- 定义两个独立 task：
build和upload:dist，后者不设"dependsOn" -
upload:dist的"args"直接用"${workspaceFolder}/dist/"，避免硬编码路径 - 目标服务器地址别写死，用
${input:deployTarget}，并在inputs数组里定义选项（如staging、prod） - 加
"problemMatcher": []，否则rsync的进度行（如12.45 MB 100%）会被误判成错误塞进“问题”面板 - 权限相关错误（如
Permission denied (publickey)）不是任务配置问题，而是 SSH key 没配好或没加载，VSCode 不管这一层
真正卡住人的从来不是 tasks.json 的语法，而是 PATH 是否完整、终端类型是否匹配、SSH key 是否可用这三件事——尤其当你在 macOS 上用 Homebrew 安装了 rsync 却忘了告诉 VSCode 它在哪。
