sftp插件本身不支持保存后执行远程命令，因其仅为文件同步工具，无ssh命令执行接口；需通过vscode tasks.json定义任务，结合ssh调用实现“保存即重启”。
为什么 SFTP 插件本身不支持保存后执行远程命令
SFTP 插件（如 liximomo.sftp）本质是文件同步工具，它的核心能力是上传/下载/删除文件，不提供 SSH 执行命令的接口。你看到的 uploadOnSave 或 watcher 配置，只触发文件传输动作，不会自动调用 ssh 或 curl 等工具去跑 systemctl restart myapp 这类命令。
必须配合 VSCode 的 tasks + shell 命令实现“保存即重启”
真实可行的路径是：利用 VSCode 的 tasks.json 定义一个任务，该任务先触发 SFTP 同步（通过 sftp.config 中的 uploadOnSave 保证文件已传），再用 shell 调用 ssh 执行远程命令。关键在于把两个动作串成一个原子任务，并绑定到保存事件。
操作步骤如下：
- 确保本地已配置好免密 SSH 登录：运行
ssh user@host不输密码就能连上 - 在项目根目录创建
.vscode/tasks.json，内容类似：
{
"version": "2.0.0",
"tasks": [
{
"label": "save-and-restart",
"type": "shell",
"command": "ssh user@host 'systemctl --user restart myapp || echo "restart failed"'",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
},
"problemMatcher": []
}
]
}
- 在
.vscode/settings.json中启用保存时运行该任务："emeraldwalk.runonsave": {"commands": [{"match": "\.js$|\.py$|\.html$", "cmd": "npm run save-and-restart"}]}（需先安装插件emeraldwalk.runonsave） - 或者更轻量：直接用
file-watcher类插件监听保存，触发workbench.action.terminal.runSelectedText（但需提前在终端粘贴好命令）
常见失败原因和绕过方法
实际落地时最常卡在权限和路径问题上：
-
Permission denied (publickey)：不是插件问题，是本地 SSH 密钥没加到ssh-agent，运行ssh-add -l检查，没输出就执行ssh-add ~/.ssh/id_rsa -
Failed to start myapp.service: Unit myapp.service not found：服务名写错，或用了--user却把 service 文件放到了/etc/systemd/system/（应放~/.config/systemd/user/并运行systemctl --user daemon-reload） - SFTP 上传还没完成，SSH 命令就执行了：在
command中加sleep 1或改用rsync+ssh合并为单条命令，例如：rsync -avz ./src/ user@host:/var/www/myapp/src/ && ssh user@host 'systemctl restart myapp'
替代方案：用 nodemon / supervisor 等进程守护工具监听文件变化
如果应用是 Node.js/Python 类型，比“VSCode 触发重启”更健壮的做法，是在服务器上直接监听文件变动：
- Node.js 项目：在服务器上运行
nodemon --watch /var/www/myapp --exec npm start，VSCode 只管 SFTP 上传，不用管重启逻辑 - Python Flask：用
flask run --reload或honcho start配合Procfile - 优势：不依赖本地编辑器行为，CI/其他编辑器也能生效；劣势：需要服务器有对应运行时环境
真正麻烦的从来不是“怎么写那行命令”，而是确认 ssh 能静默登录、systemctl 权限正确、服务定义无语法错误——这些必须手动在服务器上逐条验证，不能靠 VSCode 插件兜底。
