VSCode 不支持保存时自动上传 SFTP 文件,因其无内置 SFTP 客户端;Settings Sync 仅同步自身配置,不触发上传行为;sftp 扩展的 uploadOnSave 需手动启用并正确配置。

VSCode 本身不支持保存时自动上传 SFTP 文件,这不是同步配置问题,而是功能缺失——它压根没内置 SFTP 客户端或保存即上传机制。
为什么 Settings Sync 对 SFTP 完全无效
Settings Sync 只管 VSCode 自身的配置:比如 settings.json、插件列表、快捷键。它不管你在编辑什么文件,更不会监听文件保存事件去触发远程传输。SFTP 是第三方扩展(如 sftp by liximomo)提供的能力,其行为由该扩展自己控制,和 Settings Sync 零关联。
- 你改了
settings.json里的sftp.config路径,这个配置能被同步——但同步后另一台机器上仍需手动安装sftp扩展才能生效 -
sftp扩展自己的上传逻辑(比如"uploadOnSave": true)必须在本地settings.json中显式开启,且只对当前工作区或用户设置生效 - 如果某台机器没装
sftp扩展,即使同步了相关配置,保存也不会触发上传——VSCode 根本不认识那些 SFTP 字段
sftp 扩展的 uploadOnSave 不生效的常见原因
就算装了扩展、开了选项,保存也不上传,大概率卡在这几个地方:
-
"uploadOnSave"必须写在工作区设置(.vscode/settings.json)或用户设置里,且值为true(不是字符串"true") - 目标文件路径必须匹配
sftp配置中定义的"remotePath"和"files"模式;例如你编辑的是/project/src/index.js,但配置里"files": ["src/**"]且"remotePath": "/var/www",那它才可能上传 - 扩展首次运行时会提示“是否信任此工作区”,点“否”会导致所有自动行为(包括 uploadOnSave)被禁用,需手动在命令面板执行
SFTP: Trust Workspace - 保存的是未保存的脏文件(右上角有圆点),
sftp不会上传——必须先Ctrl+S写入磁盘
真正可靠的保存即上传方案
别依赖 Settings Sync 管 SFTP 行为。把关键配置固化下来,避免每台机器重复调试:
- 在项目根目录建
.vscode/sftp.json,填好host、port、username、remotePath等——这个文件可提交 Git,多人共享 - 在
.vscode/settings.json里写死:"sftp.uploadOnSave": true,并确保"files.associations"或"files.exclude"不误拦目标文件 - 敏感字段如密码,改用
privateKeyPath+ SSH key,或用系统 keychain(macOS Keychain / Windows Credential Manager),避免硬编码进配置 - 如果用的是企业环境禁 GitHub 登录,就别开 Settings Sync 的 SFTP 相关项——
sync.ignoredSettings里加一行"sftp.*",防止误同步导致覆盖本地正确配置
最易被忽略的一点:SFTP 上传是异步的,保存后立刻关掉文件或断网,上传就会静默失败。打开 VSCode 底部状态栏的 sftp 进度条(通常显示 “Uploading…”),或者看输出面板切换到 SFTP 标签,才能确认是否真传过去了。


















