提到Sublime Text的远程编辑,很多人第一个想到的就是RemoteSublime这个插件。但说实话,这个方案已经过时了,如果你还在按老教程折腾它,大概率是在浪费时间。

RemoteSublime 不是 Sublime 的远程编辑方案
RemoteSublime 这个插件,早在2016年就停止更新了,跟现在的Sublime Text 4(Build 4143+)完全不兼容。它依赖的 sublime.Settings API 早就被废弃了,运行环境还是Python 2.7——你在ST4里装它,要么直接报 ImportError: No module named 'urllib3',要么就悄无声息地失败。更重要的是,它压根不是“局域网同步编辑”工具:它的工作方式是把本地文件通过HTTP POST推到另一台机器上运行的简易Python服务器,没有认证、没有加密、没有冲突检测,更不支持双向同步或光标协同。说白了,就是个单向推送的小脚本。
为什么 RemoteSublime 在局域网里也跑不起来
就算你退回到Sublime Text 3(Build 3211),RemoteSublime在现代系统里依然跑不动,几个硬伤几乎是致命的:
- 远程端得手动跑
python server.py,但这脚本依赖Python 2的SimpleHTTPServer,在macOS 12+/Linux 2024+默认Python 3.9+环境里直接崩溃 - 它监听
0.0.0.0:8000,而新版的macOS和Linux防火墙默认拦截非签名进程的入站连接,关键是一点提示都没有;Windows防火墙更干脆,直接丢包了事 - 没有文件锁机制:两个人同时保存同一个文件,后写的人会无条件覆盖前者,没有差异提示,没有回滚选项
- 路径处理脆弱到离谱:
remote_path字段里如果带了空格或中文,URL编码当场失败,服务端直接500错误,但客户端那边毫无反应
真正能在局域网用的替代方案
如果你想要的是“一台电脑改,另一台实时看到变化”,那就得先想清楚自己到底需要什么场景,再选合适的工具:
- 单向同步(A编辑→B查看):用
rsync --watch+inotifywait(Linux/macOS)或robocopy /MON:1(Windows)。B端用Sublime正常打开文件夹,需要刷新时手动执行File → Revert,注意别开Auto Sa ve - 双向编辑但不实时:走Git,每次切换前跑
git pull --rebase,配合GitSa vvy插件集成命令面板,省掉终端来回切换的麻烦 - 真局域网协作(带光标、聊天、权限控制):这个RemoteSublime绝对做不到,必须换工具——VS Code的
Live Share支持局域网直连,无需公网穿透;JetBrains Gateway 可以通过SSH连本地Docker容器。这两者都经过2026年实测,稳定可用
sftp-config.json 放错位置是最常见的“以为装了却没反应”原因
不少人试RemoteSublime失败后转投SFTP插件,结果还是连不上。核心卡点往往不是密码或密钥,而是配置文件压根没被加载:
sftp-config.json必须放在你通过Project → Add Folder to Project添加的本地文件夹根目录下,用户目录、Sublime Packages目录、桌面都不行- 文件名必须全小写、无空格、无额外后缀:
sftp-config.json才对,SFTP-config.json不行,sftp-config.json.txt更不行 - 如果用密钥登录,配置里必须删掉
password字段,只保留private_key,且文件权限得是600(Linux/macOS),Windows下路径要使用正斜杠 upload_on_sa ve只对“当前文件属于该映射项目子目录”有效——你双击桌面上的index.php,就算同名配置存在,也不会触发自动上传