sublime text 不支持原生 ssh 远程编辑,需依赖 sftp 插件(如 wbond 版)或 sshfs 挂载实现;sftp 插件通过自动上传/下载同步文件,sshfs 则将远程目录挂载为本地路径,二者均需注意路径绝对性、权限设置及网络稳定性。

Sublime Text 本身不支持 SSH 远程编辑
它不是 VS Code 或 Vim,没有内置的远程文件系统能力。所谓“Sublime 连接 SSH”,实际是靠第三方插件或外部工具间接实现,核心只有两条路:本地挂载远程目录(如 sshfs),或用插件模拟 SFTP 上传/下载。直接输入 ssh user@host 是无效的,subl 命令也不识别远程路径语法。
SFTP 插件是最常用、最轻量的方案
推荐安装 SFTP 插件(作者:wbond),它不走 SSH 隧道直连,而是基于 SFTP 协议做文件同步——本质是保存时自动上传,打开时自动下载。
- 安装后右键项目文件夹 →
Map to Remote...,生成sftp-config.json -
host填服务器 IP,user填用户名,remote_path必须以/开头(比如/home/user/project) - 密码登录需填
password;密钥登录则设private_key路径(如~/.ssh/id_rsa),并确保权限为600 - 别忽略
upload_on_save和sync_down_on_open,它们控制是否自动同步——关掉前者,改完文件不会立刻覆盖服务器
sshfs 挂载适合频繁切换、多项目协作场景
把远程目录当成本地磁盘用,Sublime 完全无感,但依赖系统级支持,macOS/Linux 可行,Windows 需 WSL2 或 WinFsp + SSHFS-Win。
- macOS 执行:
sshfs user@host:/path/to/remote /local/mount/point -o follow_symlinks - 挂载后,在 Sublime 中直接
File → Open Folder选/local/mount/point - 注意:网络中断时 Sublime 可能卡死或报
Input/output error;退出前务必先umount /local/mount/point - 挂载点不能有空格或中文,否则 Sublime 可能无法识别路径
别踩这些坑
很多人配半天连不上,问题往往不在 SSH 本身,而在路径、权限或缓存。
-
sftp-config.json里remote_path写成~/project—— 不生效,SFTP 插件不解析波浪号,必须写绝对路径 - 服务器端
sshd_config关了 SFTP(Subsystem sftp internal-sftp被注释或删了)—— 会报错Unexpected server response while fetching directory listing - Sublime 缓存了旧连接配置,改完
sftp-config.json后没重启 Sublime,导致设置不生效 - 用密钥登录却忘了
chmod 600 ~/.ssh/id_rsa,插件静默失败,日志里只显示Authentication failed
远程编辑真正的麻烦点不在配置,而在于你永远分不清当前看到的是本地缓存还是服务器实时内容——尤其多人共用一个远程目录时,sync_down_on_open 开关一定要按需调,别图省事一直开着。









