Sublime Text 不支持原生远程编辑模式,所谓“远程编辑”仅能通过 SFTP 插件(文件同步)或 rsub + SSH 反向隧道(终端触发本地打开)实现,二者在路径写法、权限模型和适用场景上存在本质区别。

Sublime Text 没有“远程编辑模式”这个开关——它压根不支持原生远程会话,所有所谓“远程编辑”都是靠插件桥接实现的,且本质是文件同步或端口转发,不是 VS Code 那种进程级远程。
别信“开启远程编辑模式”的说法
Sublime Text 的 subl 命令只认本地路径和 file:// URL,遇到 user@host:/path 这类 SSH URI 会直接报 Unable to parse path 或静默失败。这不是配置问题,是内核限制。
- 没有“远程编辑模式”菜单项、设置项或命令
- 任何宣称“一键开启远程编辑”的教程,背后必然是 SFTP 插件或 rsub + SSH 隧道
- 所谓“远程编辑”,实际只有两种落地方式:文件拉取/上传(SFTP),或远程命令触发本地打开(rsub)
SFTP 插件:适合文件级同步编辑
这是最常用、最稳定的方案,适合单人维护、小项目快速修改。核心是让本地 Sublime 和远程目录保持双向或单向同步。
- 必须用绝对路径填
remote_path,"~/project"会被当字面量处理,最终访问的是/home/user/~/project,必然失败 -
upload_on_save设为true后,每次Ctrl+S就上传,但注意:如果服务器上文件被其他人改过,你本地保存会直接覆盖,无冲突提示 - 禁用
sync_down_on_open(默认 false),除非你确认本地副本完全可丢;开启后双击远程文件会立刻用服务器版本覆盖本地,协作中极易丢代码 - 私钥路径必须写绝对路径,
"ssh_key_file": "~/.ssh/id_rsa"不生效,得写成"/home/deploy/.ssh/id_rsa" - 改完
sftp-config.json必须重启 Sublime Text,插件不热重载配置
rsub + SSH 反向隧道:适合终端驱动的临时编辑
它不是“连接服务器”,而是让远程终端执行 rsub file.py,通过 SSH 把请求“反向打回”本地 Sublime。适合在服务器上排查日志、改配置时快速唤起编辑器。
- 远程执行
ssh -R 52698:localhost:52698 user@your_local_ip是必须步骤;只连服务器本身(user@localhost)或漏掉-R都连不上 - 远程需安装
rsub(gem install rsub --user-install),且which rsub必须有输出;Sublime 启动时若没读到 shell 的$PATH(比如 zsh 用户没配好~/.zshrc),就会报Command not found: rsub - rsub 进程必须和 SSH 会话绑定运行,不能用
nohup或 systemd 启,否则隧道断开服务就死 - Windows 用户基本不用考虑 rsub,WSL2 + X11 转发极不稳定,建议直接切 SFTP
真正容易被忽略的点是:SFTP 的 remote_path 和 rsub 的 SSH 隧道权限模型完全不同,前者依赖文件系统权限(你得对远程目录有读写权),后者依赖 SSH 认证和端口转发策略(服务器 /etc/ssh/sshd_config 中 GatewayPorts 若为 no,-R 会静默失败)。选哪条路,先看你是想“像编辑本地一样操作远程文件”,还是“在服务器上敲命令时顺手打开编辑器”。


















