Sublime Text安装RemoteSublime实现局域网同步编辑的方法

提到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，就算同名配置存在，也不会触发自动上传