SFTP插件可实现Sublime Text与远程服务器的文件同步。安装后通过File → SFTP → Setup Server生成sftp-config.json配置连接参数,设置host、user、remote_path等信息,并启用sync_up_on_save和sync_down_on_open实现自动同步。支持密钥登录、忽略特定文件、多环境切换及手动上传下载,提升远程开发效率。

在使用 Sublime Text 进行远程开发时,SFTP 插件是实现本地与服务器文件同步的高效工具。通过正确配置,可以实现实时上传、下载、编辑远程文件,提升开发效率。以下是详细的配置步骤和注意事项。
安装 SFTP 插件
打开 Sublime Text,确保已安装 Package Control。按下 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(Mac)调出命令面板,输入 “Install Package”,选择对应选项。等待包管理器加载完成后,搜索 “SFTP” 并安装。
配置 SFTP 连接信息
安装完成后,需要为项目设置远程服务器连接参数:
- 在菜单栏选择 File → SFTP → Setup Server,会自动生成一个
sftp-config.json配置文件。 - 该文件包含连接方式、主机地址、登录凭据等关键字段。
常见配置示例如下:
{
"type": "sftp",
"sync_down_on_open": true,
"sync_up_on_save": true,
"sync_skip_deletes": false,
"host": "your.server.com",
"user": "username",
"port": "22",
"remote_path": "/home/username/project/",
"connect_timeout": 30,
"ssh_key_file": "~/.ssh/id_rsa"
}
说明:
- sync_down_on_open:打开文件时自动从服务器下载最新版本。
- sync_up_on_save:保存文件时自动上传到服务器,这是实现同步的核心选项。
- remote_path:服务器上对应的项目根目录,需确保路径存在且权限正确。
- 若使用密钥登录,填写正确的私钥路径;否则可添加
"password": "yourpass"(不推荐明文存储密码)。
将 SFTP 应用于现有项目
如果已有本地项目,可通过以下方式绑定远程路径:
- 打开项目文件夹后,右键点击侧边栏中的文件夹,选择 SFTP → Map to Remote。
- Sublime 会在该目录下生成
sftp-config.json,按需修改配置即可。
常用功能与技巧
- 手动同步:右键文件或文件夹,选择 Upload / Download 可单独传输。
- 查看日志:通过 Tools → SFTP → Show Log 检查连接或传输错误。
- 忽略特定文件:在配置中添加
"ignore_regexes",例如过滤临时文件:"ignore_regexes": [".git", ".DS_Store", "*.tmp"] - 多环境支持:可在配置中使用多个服务器定义,通过切换 profile 管理不同环境(如测试、生产)。
基本上就这些。只要网络稳定、权限配置正确,SFTP 能很好地支撑日常远程开发需求。注意定期备份重要数据,避免因误操作导致文件丢失。









