Sublime Text 编辑远程文件需依赖插件,推荐SFTP插件(全平台、稳定、免额外依赖),配置须设"upload_on_save": true、用ssh_key_file而非明文密码、remote_path末尾不加斜杠;rsub方案限制多,需正确配置SSH反向端口转发且仅适用于Linux/macOS。

Sublime Text 本身不支持直接 SSH 编辑远程 Linux 文件,必须靠插件或桥接工具实现。主流可靠方案只有两个:SFTP 插件(推荐)和 rsub(Ruby 实现,限制多)。别信“内置 SSH 支持”这类说法——它根本不存在。
用 SFTP 插件编辑远程文件最稳,但配置容易漏关键项
SFTP 是目前 Sublime 上最成熟、兼容性最好、Windows/macOS/Linux 全平台可用的方案。它走标准 SSH 协议,不依赖 Ruby 或额外守护进程,出问题也容易定位。
- 安装后必须通过 右键侧边栏文件夹 → SFTP > Map to Remote… 生成配置,而不是只用
Setup Server;后者只建连接,不绑定本地目录,保存不会自动上传 - 配置里
"upload_on_save": true必须显式设为 true,默认是false,否则改完 Ctrl+S 完全没反应 - 密码明文写进配置极不安全,优先用
"ssh_key_file": "~/.ssh/id_rsa";Windows 用户若用 PuTTY 密钥,得先用puttygen转成.ppk格式,路径填绝对路径如"D:\keys\server.ppk" - 如果远程路径是
/var/www/html,"remote_path"值末尾不能加斜杠(即写"/var/www/html",不是"/var/www/html/"),否则浏览服务器时会报Invalid path
rsub 启动成功也不代表能用,SSH 端口转发是最大坑点
rsub 看起来轻量,但实际对环境要求苛刻:它本质是让远程的 Ruby 进程监听 127.0.0.1:52698,再靠 SSH 把这个本地端口“反向暴露”给 Sublime。只要转发链断一环,就卡在 Connecting… 或报 Connection refused。
- 远程执行
rsub后,必须确认它真的在跑:lsof -i :52698或netstat -tuln | grep 52698,输出应含127.0.0.1:52698;若显示*:52698,说明启动时加了--bind错误参数,得重跑 - 本地连远程的 SSH 命令必须是:
ssh -R 52698:localhost:52698 user@host;-R是对的,但语义不是“远程监听”,而是“把远程的 52698 绑定到我本地的 52698”——这是 SSH 的反直觉设计 - Mac 或 Linux 上 Sublime 找不到
rsub命令,大概率是启动 Sublime 时 shell 的$PATH没加载进 GUI 环境;临时解决:终端里运行open -a "Sublime Text"启动,而非点击图标 - Windows 用户基本不用试
rsub;WSL2 + X11 转发太重,且 Sublime for Windows 根本不调用 WSL 的PATH,which rsub永远失败
文件乱码、权限错、同步失败?先看这三处
很多“编辑不了”其实是编码或权限导致的静默失败,不是连接问题。
- 中文文件名/内容乱码:在
sftp-config.json中加"remote_encoding": "utf-8",并确保远程 Linux 的 locale 是en_US.UTF-8或zh_CN.UTF-8(locale命令查看) - 保存后远程文件权限变成
600,网站打不开:配置里明确设"file_permissions": "644"和"dir_permissions": "755",否则 SFTP 插件按 umask 默认行为处理 - 修改后不上传,或上传空文件:检查
"sync_down_on_open": true是否开启;若关了,首次打开是本地缓存副本,改完保存只会写本地,不会触碰远程
真正麻烦的不是选哪个方案,而是 SFTP 配置里一个逗号少写、rsub 的 SSH 转发少敲一个 localhost,就会让你卡半小时。建议第一次配好后,把完整配置和启动命令存成文本片段,下次直接复制粘贴。


















