安装SFTP插件后,通过Map to Remote生成配置文件并填写服务器信息,开启自动同步,即可在本地编辑远程文件。

使用 Sublime Text 的 SFTP 插件可以方便地远程编辑服务器上的文件,实现本地化操作远程项目。以下是详细配置步骤和使用方法。
安装 SFTP 插件
确保你已安装 Package Control,然后按以下步骤安装 SFTP:
- 打开 Sublime Text,按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)调出命令面板
- 输入 Install Package 并选择对应选项
- 搜索 SFTP,点击安装
安装完成后,SFTP 插件即可使用。
配置 SFTP 连接服务器
连接前需准备好服务器信息:IP 地址、端口、用户名、密码(或私钥)、远程路径等。
配置步骤如下:
- 在 Sublime 中打开一个本地文件夹(该文件夹将映射为远程目录)
- 右键点击侧边栏的文件夹名,选择 SFTP > Map to Remote...
- Sublime 会自动生成一个 sftp-config.json 配置文件
修改配置文件内容示例:
{
"type": "sftp",
"sync_down_on_open": true,
"sync_up_on_save": true,
"sync_skip_deletes": false,
"confirm_downloads": false,
"confirm_sync": true,
"host": "your.server.ip",
"user": "your_username",
"password": "your_password",
// 或使用私钥:
// "private_key_path": "/path/to/id_rsa",
"port": "22",
"remote_path": "/home/your_username/project/",
"ignore_regexes": [
"\\.sublime-(project|workspace)",
"sftp-config\\.json",
".git",
"node_modules"
]
}
关键参数说明:
- sync_down_on_open:打开文件时自动从服务器下载最新版本
- sync_up_on_save:保存文件时自动上传到服务器
- remote_path:服务器上对应的项目根目录
- ignore_regexes:忽略同步的文件或目录
使用 SFTP 编辑远程文件
配置完成后,就可以像操作本地文件一样使用:
- 打开映射的文件夹,浏览远程文件结构(通过右键 → SFTP > Browse Server)
- 双击文件自动下载并打开
- 编辑后按 Ctrl+S 保存,文件自动上传到服务器
- 可通过右键菜单手动执行 Download File / Upload File
建议开启 sync_up_on_save,这样每次保存都会同步,避免遗漏更新。
常见问题与注意事项
- 确保服务器开启了 SSH/SFTP 服务(默认端口 22)
- 若使用密钥登录,注意私钥权限(通常应为 600),路径写绝对路径
- 防火墙或安全组需放行对应端口
- 网络不稳定时可关闭自动同步,改为手动上传
- sftp-config.json 不应提交到版本控制(如 Git)
基本上就这些。配置一次后,后续打开项目即可直接编辑远程文件,效率很高。









