Sublime Text需通过Package Control安装wbond版SFTP插件并配置sftp-config.json（含host、user、ssh_key_file、remote_path等字段），开启upload_on_sa ve方可实现保存即上传，仅支持SFTP协议，不兼容纯FTP。
开门见山，先说一个核心事实：Sublime Text 编辑器本身，压根就不支持 FTP 或 SFTP 上传功能。所以，网上常说的“配置FTP上传”，在 Sublime 里其实是个技术上的“代称”——它只能通过 SFTP（也就是基于 SSH 的文件传输协议）来实现。而实现这一切，必须依赖一个第三方插件。目前，唯一靠谱且仍在维护的解决方案，就是 wbond 开发的 SFTP 插件。但这里有个关键限制：这个插件只认 SFTP，完全不兼容传统的 FTP 协议。如果你的服务器只开了 FTP 端口，那很抱歉，这条路从一开始就走不通。
Sublime 安装 SFTP 插件必须用 Package Control，手动放文件夹无效
很多朋友图省事，喜欢手动下载插件压缩包，解压到 Packages/ 目录。但这一招对 SFTP 插件基本无效，结果往往是菜单不出现、右键找不到选项、命令面板也搜不到——插件根本没被正确初始化。
- 第一步，先确保你的 Sublime Text 已经安装了
Package Control。怎么确认？按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），在弹出的命令面板里输入Install Package Control看看，如果已经安装，这一步可以跳过。 - 安装插件，同样打开命令面板，输入
Package Control: Install Package并回车。 - 稍等片刻，待插件列表加载完成后，搜索
SFTP。这里要睁大眼睛：**务必选择作者显示为wbond的那个**。列表里可能会有一些名字相似的仿品，比如sftp-client或早已停止更新的FTPSync，千万别选错。 - 安装完成后，记得重启一次 Sublime Text。否则，
Project菜单和右键菜单里很可能不会出现SFTP的相关选项。
sftp-config.json 必须放在项目根目录，字段错一个就静默失败
配置文件的摆放位置和内容，是新手最容易栽跟头的地方。这个插件有个“坏习惯”：它遇到配置错误时，往往不会弹出醒目的红框报错，只在状态栏一闪而过一行小字，然后一切如常，让你误以为配置没问题。其实，它已经“静默失败”了。
首先，配置文件的名字必须是 sftp-config.json，编码格式推荐 UTF-8 无 BOM。其次，它必须放在你通过 Project → Add Folder to Project 添加到 Sublime 的本地项目根目录下。放在别处，插件根本找不到。
"host"：这里只填服务器的 IP 地址或域名，**千万别画蛇添足加上ftp://或sftp://前缀**。正确示例："host": "192.168.1.100"。"user"：填写的是 SSH 登录用户名，可不是你网站控制面板的账号。如果使用密钥登录，请务必删除或留空"password"字段，否则会冲突。"ssh_key_file"：私钥文件的路径，这里要求是绝对路径。Linux 或 macOS 下类似"/home/you/.ssh/id_rsa"，Windows 下则是"C:/Users/You/.ssh/id_rsa"（注意，使用正斜杠/通常兼容性更好）。"remote_path"：服务器上的远程路径，必须以/开头的绝对路径，例如"/var/www/html/"。路径结尾加不加斜杠，会影响文件上传的具体位置，需要根据实际情况调整。"port"：默认是 22。如果你的服务器修改过 SSH 端口，这里必须明确写出来，比如"port": 2222。
upload_on_sa ve 不生效？大概率是项目没绑定或路径不匹配
明明在配置里设置了 "upload_on_sa ve": true，保存文件时却毫无反应？别急着怀疑插件坏了，问题很可能出在“绑定”上——Sublime 根本不知道当前编辑的文件，应该同步到远程服务器的哪个位置。
- 最可靠的绑定方法是：在 Sublime 侧边栏，右键点击本地项目的根文件夹，然后选择
SFTP → Map to Remote…。这个操作会自动生成或关联配置文件。 - 对于高级用户，也可以手动创建
.sublime-project项目文件，并在其中嵌入 SFTP 配置块。 - 文件上传的映射关系，依赖于本地路径与
remote_path的对应。举个例子，如果remote_path是/var/www/html/，你编辑的本地文件是js/app.js，那么它就会被上传到/var/www/html/js/app.js。但如果你编辑的是项目外的文件，比如../config.php，插件就不会触发上传。 - 另外，网络环境不佳时，默认的 3 秒超时可能太短。可以在配置里增加
"timeout": 10来提升容错率。
上传成功但网页 500？别怪插件，看权限和 SELinux
需要警惕的是，SFTP 插件只负责“搬运工”的工作——把文件字节传过去。至于文件上传后，网站能否正常运行（比如 PHP 报 500 错误、CSS/JS 加载不了），这完全是 Web 服务器环境的问题，与插件本身无关。绝大多数情况，都是文件权限或系统安全策略（如 SELinux）在作祟。
- 插件默认上传的文件权限是
644，目录权限是755。但对于某些特定环境（例如 suPHP、或者配置了 open_basedir 限制），可能需要文件所有者匹配，或者更严格的权限设置。 - 你可以在配置文件中尝试添加
"file_permissions": "644"和"dir_permissions": "755"来明确指定权限，但这前提是服务器接受这样的设置。 - 一个更稳妥的做法是：上传文件后，立刻执行一条远程命令来修正权限。按下
Ctrl+Shift+P，输入SFTP: Execute Command，然后输入类似chmod 644 index.php的命令。 - 如果上传时总提示
Failed to write file，但状态又显示Success，这种矛盾现象很可能是被 SELinux 拦截了。登录服务器，执行命令ausearch -m a vc -ts recent查看安全日志，就能找到蛛丝马迹。
说到底，配置能否真正跑通，关键不在于 JSON 文件写得多么漂亮，而在于底层条件是否满足：SSH 连接是否畅通、远程路径是否可写、以及文件权限是否被操作系统层面的安全策略卡住。这些问题，恰恰是插件最“沉默”的地方，一出问题，它可能连个像样的错误提示都不会给你。
