Sublime Text 通过 SFTP 插件实现远程文件浏览、上传、下载和实时编辑,需用 Package Control 安装插件,配置 sftp-config.json 连接信息,并依赖本地缓存与自动同步机制完成双向操作。

Sublime Text 本身不支持远程编辑,但通过 SFTP 插件 可以实现类似 FTP 客户端的远程文件浏览、上传、下载和实时编辑功能。关键在于正确安装插件、配置连接信息,并理解其工作模式(本地缓存 + 自动同步)。
安装 SFTP 插件
推荐使用 Package Control 安装,稳定且更新及时:
- 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)打开命令面板
- 输入 Install Package,回车后等待列表加载
- 搜索 SFTP,选择并回车安装(作者是 wbond,注意别选错)
- 安装完成后重启 Sublime(部分版本需要)
配置远程服务器连接
安装后不能直接连接,需手动创建配置文件:
- 在 Sublime 中打开要编辑的本地文件夹(File → Open Folder…)
- 右键该文件夹 → SFTP → Map to Remote…
- 会自动生成一个 sftp-config.json 文件,用 Sublime 打开它
- 填写基础连接信息,例如:
{
"type": "sftp",
"sync_down_on_open": true,
"sync_same_age": true,
"host": "192.168.1.100",
"user": "your_username",
"password": "your_password",
"port": "22",
"remote_path": "/var/www/html/",
"ignore_regexes": [".git", ".DS_Store", "node_modules"]
}
常用字段说明:
type:固定填 sftp(也支持 ftp、ftps)
sync_down_on_open:打开文件时自动从服务器拉取最新版
remote_path:服务器上对应这个本地文件夹的路径
ignore_regexes:跳过同步的文件/文件夹(正则匹配)
日常使用与同步逻辑
SFTP 不是“直连编辑”,而是基于本地缓存的双向同步机制:
- 首次打开远程文件夹时,会自动下载全部内容到本地(可取消,但建议保留)
- 修改并保存本地文件后,SFTP 默认自动上传到服务器(无需手动操作)
- 如多人协作,别人改了服务器文件,你可右键 → SFTP → Download File 手动拉取
- 右键文件或文件夹还可快速执行:Upload、Download、Rename、Delete 等
常见问题处理
连接失败?上传没反应?先检查这几项:
-
SSH 服务是否开启:服务器需运行
sshd,且端口(默认 22)未被防火墙拦截 -
用户权限是否足够:确保配置中的
user对remote_path有读写权限 -
密码或密钥方式:若用私钥登录,把
"password"改为"private_key"并填入私钥绝对路径(如"C:/Users/xxx/.ssh/id_rsa") -
中文路径乱码:在配置中添加
"charset": "utf-8"
基本上就这些。SFTP 插件轻量、稳定,适合中小项目快速调试。不需要复杂 IDE,也能获得接近本地开发的流畅体验。










