Sublime Text 借助 SFTP 插件可实现本地编辑+自动上传/下载的类远程开发体验;需正确配置 sftp-config.json(含 type、host、user、private_key、remote_path 等),启用 upload_on_save,并合理设置 ignore_regexes、sync_down_on_open 等同步策略以避免冲突。

Sublime Text 本身不支持远程开发,但借助 SFTP 插件可以实现本地编辑 + 自动上传/下载,达到类远程开发的体验。关键在于正确配置连接参数和同步行为,避免覆盖、冲突或权限问题。
安装并激活 SFTP 插件
通过 Package Control 安装 SFTP(注意:不是 “sftp” 小写,而是官方大写的 “SFTP”)。安装后重启 Sublime,右键任意文件或文件夹,应能看到 SFTP → Map to Remote 或 Browse Remote 等选项。若无此菜单,请检查是否安装成功或 Sublime 版本兼容(SFTP 支持 Sublime Text 3 和 4)。
配置服务器连接信息(sftp-config.json)
在本地项目根目录下,右键 → SFTP → Map to Remote,自动生成 sftp-config.json。需手动编辑该文件,填写真实服务器信息:
-
type:填
sftp(不可写 ftp/scp) - host:服务器 IP 或域名
- port:一般为 22(SSH 默认端口)
- user:登录用户名
-
password 或 private_key:推荐用私钥(路径如
~/.ssh/id_rsa),更安全 -
remote_path:服务器上对应项目的绝对路径,如
/var/www/myapp -
upload_on_save:设为
true实现“保存即上传”
设置合理的同步策略
默认全量同步易出错,建议按需调整:
- 用 sync_down_on_open 控制是否打开文件时自动拉取最新版(团队协作建议设为
true) - 用 ignore_regexes 排除临时文件、日志、node_modules 等,例如:
["\\.git", "\\.log$", "node_modules/"] - 修改 preserve_modification_times 为
false可避免因时间戳差异触发误同步 - 如需双向同步(慎用),需配合 sync_skip_deletes 防止本地删了也删服务器
日常使用与排错提示
上传失败常见原因有:权限不足(检查 remote_path 所属用户/组)、路径不存在(先 ssh 登录创建好目录)、私钥无读权限(chmod 600 ~/.ssh/id_rsa)。调试时可开启 log_level: 2 查看详细日志(输出在 Sublime 控制台 Ctrl+`)。上传成功后,状态栏会显示 “Uploaded …” 提示。
基本上就这些。SFTP 不是真正的远程执行环境,但它足够轻量、稳定,适合 PHP、Python 脚本、静态站点等无需复杂调试的场景。只要配置一次,后续编辑就像操作本地文件一样自然。










