Sublime Text 3 安装 SFTP 插件需通过 Package Control 搜索安装并重启编辑器；配置文件必须为项目根目录下的 sftp-config.json，且含 host、user、remote_path 等必填项；上传失败多因认证错误、路径权限问题或未开启 upload_on_save。
Sublime Text 3 怎么装 SFTP 插件（不是 Package Control 自带的“SFTP”）
官方插件市场里叫 SFTP 的那个，就是你要找的远程同步插件——但它**不支持 Sublime Text 4**，且必须通过 Package Control 安装，不能手动拖进插件目录。
常见错误现象：Package Control: Install Package 搜索不到 SFTP，或者装完没反应、右键没 SFTP 菜单；本质是没装对源，或用了 ST4。
- 确认你用的是
Sublime Text 3（Help → About Sublime Text查版本） - 打开
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 等待列表加载完成，再输入
SFTP，选中后回车安装 - 安装完重启 Sublime（不重启，右键菜单不会出现
SFTP选项）
装完 SFTP 插件，怎么配服务器连接（sftp-config.json）
配置文件名必须是 sftp-config.json，放在项目根目录下，不是用户目录也不是插件目录。名字错一个字符、多一个空格，插件就直接静默失败，没有任何报错提示。
典型使用场景：本地写代码，保存自动上传到测试服务器；或右键 SFTP → Browse Server 查看远端文件结构。
-
host、user、password或private_key必填；port默认22，改过 SSH 端口要显式写上 -
remote_path是服务器上的目标路径，必须以/开头（如/var/www/html），结尾不加/ - 如果用密钥登录，
private_key填绝对路径（Windows 用双反斜杠或正斜杠，如C:/Users/me/.ssh/id_rsa） - 配置保存后，右键任意文件 →
SFTP → Map to Remote才会激活同步逻辑
SFTP 上传失败常见报错和对应解法
插件不报红框错误，只在右下角状态栏闪一下文字，容易忽略。真正出问题时，最常卡在三处：认证、路径、权限。
-
Authentication failed：密码错 / 密钥没权限 / 服务器禁用了密码登录（检查sshd_config中PasswordAuthentication yes） -
No such file或Permission denied：remote_path写错，或当前用户对目标目录无写权限（别指望 root 权限自动生效） - 右键没
SFTP菜单：确认项目已打开（不是单个文件），且sftp-config.json在该目录下，文件编码是 UTF-8 无 BOM - 保存后不上传：检查配置里
"upload_on_save": true是否开启（默认是true，但手动改过可能关了）
为什么不用 FTP/SFTP 插件做生产环境部署
它适合开发调试阶段的小范围同步，不是部署工具。性能和可靠性边界很清晰：大文件（>10MB）、含中文路径、高频率保存，容易卡住或丢包；更关键的是，它没有原子性、没回滚、没 diff 预览、不支持 rsync 式增量。
- 上传中断后，不会自动重试，也不会标记失败文件
- 不校验文件一致性（比如远端被手动改过，本地保存会直接覆盖）
- 不支持多服务器批量操作，也没日志审计能力
- 真要上线，用
rsync、scp脚本或 CI/CD 工具，而不是靠编辑器插件扛
配置里最容易被忽略的一点：sftp-config.json 里的 remote_path 和本地项目路径是严格一一映射的，改了本地目录结构，必须同步调整配置，否则上传会跑到奇怪的子目录里去。
