Sublime Text 不支持原生 SSH 远程编辑,因 subl 命令仅解析本地路径和 file:// URL,不识别 ssh:// 或 user@host:/path;可行方案仅有 rsub(需反向隧道与插件配合)和 SFTP 插件(需绝对路径、禁用波浪号、重启生效),二者互斥、不可混用。

Sublime Text 本身不支持跨平台远程编辑——它没有内置 SSH 客户端,也不解析 ssh:// 或 user@host:/path 这类 URI;所谓“跨平台”,指的是你在 Windows/macOS/Linux 上用 Sublime 编辑 Linux 服务器上的文件,而不是 Sublime 自己跨平台运行远程进程。
为什么 subl user@host:/path 总是失败
这是最常踩的第一个坑:subl 命令只处理本地路径和 file:// URL,遇到带 @ 的字符串会直接忽略或报 Unable to parse path。这不是配置问题,是 Sublime 内核限制。你无论换 Windows 还是 macOS,结果都一样:静默失败、空白窗口、或者弹出错误提示。
解决思路只有两条路,且二者互斥、不可混用:
- rsub(RemoteSublime):靠 SSH 反向隧道把远程文件“推”到本地 Sublime 打开,保存即写回远程磁盘
- SFTP 插件:在本地编辑副本,保存时自动
scp同步到远程,依赖upload_on_save
rsub 在 Windows/macOS/Linux 上的共性要求
rsub 能跨平台,但前提是三要素必须同时满足,缺一不可:
- 远程服务器上装好
rsub(常见路径:/usr/local/bin/rsub),权限设为755,否则执行时报Permission denied - 本地 Sublime 已安装并启用
rsub插件(Preferences → Package Settings → rsub → Settings),端口默认是52698,防火墙不能拦 - SSH 连接必须带
-R 52698:localhost:52698参数,推荐用~/.ssh/config配 alias,例如:
Host myserver
HostName server.example.com
User deploy
RemoteForward 52698 localhost:52698
Windows 用户若用 OpenSSH(Win10 1809+ 自带),命令完全一致;若用 PuTTY,需手动在 Connection → SSH → Tunnels 里加 52698 的 remote tunnel,并勾选 “Remote ports do the same”。
SFTP 插件在不同系统下的关键差异点
SFTP 插件本身跨平台,但配置细节因系统而异:
-
remote_path必须写绝对路径,~/project在任何系统下都不展开——Windows 用户尤其容易在这里填错,以为能像 CMD 或 PowerShell 里那样用波浪号 - 私钥路径必须用正斜杠且为绝对路径:
"ssh_key_file": "C:/Users/you/.ssh/id_rsa"(Windows)或"/home/you/.ssh/id_rsa"(macOS/Linux),~/.ssh/id_rsa一定失效 - ST4(Build 41xx+)必须装
SFTP-Next,原版 SFTP 会报ImportError: No module named 'urllib3',不管你是 macOS 还是 Linux - 配置文件
sftp-config.json必须放在项目根目录(即你通过Project → Add Folder to Project加入的那个文件夹),且该文件夹要显示在侧边栏顶层,右键才会有SFTP菜单
upload_on_save 和 sync_down_on_open 到底什么时候生效
这两个选项不是“全局开关”,而是有严格触发条件:
-
upload_on_save只对属于当前项目的、路径匹配remote_path子目录的文件生效(比如remote_path是"/var/www/app",那你编辑app/src/main.py才上传,编辑app/../config.yml就不传) -
sync_down_on_open不是“每次打开都拉最新”,而是仅当本地无缓存时才下载;如果文件已存在且时间戳新于远程,它就直接打开本地副本——这会导致你看到的不是最新内容 - 两者都依赖
connect_timeout设置合理(建议20),超时太短会在网络抖动时静默跳过同步,你以为改了,其实没传过去
真正容易被忽略的是:rsub 和 SFTP 绝对不能混用在同一项目里。rsub 编辑的文件保存是直写远程,SFTP 的 upload_on_save 又会立刻再覆盖一遍,结果就是你刚保存的修改被几秒后自动上传的旧副本冲掉——这种竞态不会报错,只会让你怀疑人生。


















