VSCode文件同步保存与远程上传任务触发快捷键的配置流转-VSCode-PHP中文网

vscode保存后未自动上传，大概率因uploadonsave未设为true、.vscode/sftp.json未置于项目根目录、remotepath非绝对路径——三者任一不满足均导致静默失败。

vscode文件同步保存与远程上传任务触发快捷键的配置流转

本地修改保存后没同步到服务器？大概率是 uploadOnSave 没设为 true，或者 SFTP 插件根本没配对。这个开关必须显式打开，否则 Ctrl+S 只会存本地。

uploadOnSave 必须设为 true，且写在项目根目录下的 .vscode/sftp.json 里（不是用户级配置）
如果用了多个远程目标，确保当前打开的文件夹对应的是已配置的 SFTP 项目——VSCode 是按工作区识别配置的
remotePath 要写绝对路径，比如 /home/user/project，不能用 ~/project 或相对路径，否则上传会失败或丢文件
注意 ignore 列表：默认不忽略 .git，但如果你加了 "node_modules" 却没加 ".vscode"，可能把 sftp.json 本身也传上去了，导致远程配置被覆盖

保存自动上传适合日常开发，但首次部署或批量更新时，得靠手动上传——这时候别依赖右键菜单，效率低还容易点错。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

快捷键：没有默认绑定，需自己配。推荐在 keybindings.json 中加一条：
```
[{"key":"ctrl+alt+u","command":"sftp.uploadFile","when":"resourceScheme == 'file'"}]
```
命令面板调用更可靠：Ctrl+Shift+P → 输入 SFTP: Upload（当前文件）或 SFTP: Upload Project（整个项目）
注意区分：SFTP: Upload 上传当前打开/选中的文件；SFTP: Upload Project 上传整个工作区，但只传 sftp.json 里 remotePath 对应的映射路径，不是所有子文件夹
上传失败时，底部状态栏会显示红色错误，常见原因是权限不足或 remotePath 目录不存在——SFTP 不会自动创建父目录

两者都能“连远程”，但机制完全不同：Remote-SSH 是把 VSCode 前端连到远程后端进程，所有操作直读直写远程文件系统；SFTP 是本地编辑 + 主动上传。混用极易出问题。

不要在同一个工作区同时启用 Remote-SSH 连接和 SFTP 的 uploadOnSave ——你 Ctrl+S 一次，可能触发两次写入（一次通过 SSH 写远端，一次通过 SFTP 再传一遍），导致文件内容错乱
Remote-SSH 下无需 SFTP 插件：打开的文件天然就是远程的，保存即生效，uploadOnSave 完全无效，还会干扰状态栏的同步提示
判断当前模式：看左下角状态栏。有 “SSH: xxx” 表示走 Remote-SSH；只有 “SFTP” 图标或无标识但配置了 sftp.json，才是 SFTP 模式
切换前务必关闭所有远程终端和调试会话，否则 Remote-SSH 断开后残留进程可能卡住文件锁

直接改 keybindings.json 看似灵活，但容易因语法错误让整个快捷键系统失效——VSCode 不校验 JSON 格式，错一个逗号就静默失败。

优先用命令面板：Ctrl+Shift+P → Preferences: Open Keyboard Shortcuts (JSON)，它会自动校验并提示错误位置
绑定命令名必须准确：sftp.uploadFile、sftp.uploadFolder、sftp.downloadFile，大小写和拼写错一个字母都不生效
when 条件别漏：比如想只在编辑器有焦点时触发，加 "when": "editorTextFocus"；想在资源管理器里右键上传，得用 "resourceScheme == 'file'
避免覆盖全局快捷键：比如把 ctrl+s 绑给上传，会导致无法保存本地文件——VSCode 不阻止这种配置，但后果自负

真正麻烦的不是配置本身，而是不同同步方式之间的隐性耦合：Remote-SSH 和 SFTP 共存时，状态栏图标、保存行为、错误提示全部互相掩盖。动手前先确认你到底要“本地编辑+上传”，还是“直接编辑远程文件”——选错模式，后面所有快捷键和配置都在白调。