sublime text 不支持 ssh 远程开发,需依赖 sftp 插件(如 wbond 版)实现“保存即上传”,或通过 sshfs 挂载远程目录;二者均无远程进程、终端集成与实时同步能力,协作与调试体验弱于 vs code remote-ssh。

Sublime Text 本身不支持 SSH 远程开发,必须借助第三方插件或间接方案;直接配置 SFTP 插件是最稳定、最可控的路径,但要注意它不是实时同步,而是“保存即上传”模式。
为什么不能像 VS Code 那样用 Remote-SSH?
Sublime Text 没有内置远程文件系统抽象层,所有插件都只能在本地操作文件,再通过协议(如 SFTP/FTP)传输。这意味着:
-
SFTP插件本质是“本地编辑 + 手动触发上传/下载”,不挂载远程目录,也不运行远程进程 - 没有终端集成、无法启动远程
python或node进程,调试和运行需额外工具配合 - 不支持
ssh_config的ProxyJump或多跳登录,复杂网络需提前配置好直连 SSH 隧道
安装并配置 SFTP 插件(推荐 SFTP v3.4.1+)
该插件由 wbond 维护,目前仍是 Sublime 下最成熟的远程文件同步方案。关键操作如下:
- 用
Package Control: Install Package安装SFTP(非sftp小写包) - 右键项目根目录 →
SFTP/FTP → Map to Remote...,生成sftp-config.json - 在配置中明确指定:
host、user、remote_path(必须以/开头),避免用~ - 若用密钥登录,设
ssh_key_file为绝对路径(如/Users/me/.ssh/id_rsa),且确保权限为600 - 禁用
upload_on_save以外的自动行为(如sync_down_on_open易覆盖本地未提交修改)
常见错误:保存后没上传 / 报错 Connection refused / 权限被拒绝
这些问题基本都源于配置与 SSH 环境不匹配,而非插件本身故障:
-
Connection refused:检查目标服务器sshd是否监听 22 端口(sudo ss -tlnp | grep :22),防火墙是否放行 - “上传成功但文件内容没变”:确认
remote_path和本地路径映射正确,Sublime 编辑的是本地副本,上传动作只发生在Ctrl+S后 -
Permission denied (publickey):不是密钥路径错,就是服务端/home/user/.ssh/authorized_keys权限不对(应为600,目录700) - 中文路径乱码:在
sftp-config.json中添加"encoding": "utf-8"(仅部分服务器支持)
替代方案:用 sshfs 挂载 + Sublime 直接打开远程路径(macOS/Linux)
这是更接近“真实远程开发”的做法,但依赖系统级支持,稳定性受挂载质量影响:
- macOS:用
macFUSE+sshfs,命令如sshfs user@host:/path /mnt/remote -o follow_symlinks - Linux:内核原生支持,
sshfs包安装后即可挂载 - 挂载成功后,在 Sublime 中直接
File → Open Folder…选择/mnt/remote即可,编辑保存即实时落盘 - 注意:
sshfs断连时 Sublime 可能卡死或报Input/output error,建议搭配autofs或脚本自动重连
真正难处理的不是连接本身,而是编辑状态与远程一致性——SFTP 不会告诉你别人同时改了同一文件,sshfs 挂载又容易因网络抖动失联。如果项目需要协作或频繁调试,Sublime 并不适合当主力远程编辑器,这点常被忽略。











