floobits 在 sublime text 中无法提供真正可靠的实时协作编辑体验，因其受限于 sublime 底层 api 缺乏光标同步、操作广播与并发合并能力，实际依赖低效轮询机制，且中心服务已停运，社区替代后端稳定性差、tls 证书常过期、api 不兼容，导致连接失败、闪退、同步错乱、状态丢失等问题；推荐改用 code-server 运行 vs code 实现全功能协同。
Floobits 不能提供真正可靠的实时协作编辑体验，Sublime Text 的底层限制决定了它无法处理光标同步、操作广播和并发合并——你看到的“实时”，往往伴随延迟、冲突或状态丢失。
为什么 Floobits 在 Sublime Text 中常连不上或闪退
Floobits 依赖一个已停止维护的中心服务（floobits.com 域名于 2025 年底失效），当前多数用户连接的是社区托管的替代后端（如 floobits-community.github.io），但这些服务稳定性差、TLS 证书常过期、API 路由不兼容新版本插件。
常见现象包括：Connection refused、SSL: CERTIFICATE_VERIFY_FAILED、命令面板中 Floobits: Create Workspace 无响应。
- 确认插件是否为最新版：运行
Package Control: Upgrade Package→ 选Floobits；旧版（v3.4.2 及更早）会硬编码调用已下线的https://floobits.com - 手动替换配置文件中的 API 地址：编辑
~/.floorc.json，将"api_url"改为"https://floobits-community.github.io/api/v1" - 禁用 SSL 验证（仅调试用）：在
Preferences → Package Settings → Floobits → Settings中添加"verify_ssl": false
Floobits 同步失败时文件内容错乱的根源
Sublime Text 插件 API 不暴露 on_text_changed_async 级别的细粒度事件，Floobits 实际采用定时轮询 + diff 比对方式抓取变更，间隔默认为 500ms。这意味着：
- 两人同时在行首插入字符，可能被合并为单次覆盖（非 OT 算法，无冲突解决逻辑）
- 快速删除+粘贴操作易触发
File modified on disk. Reload?弹窗，点“Reload”会丢弃本地未同步的修改 - 选区高亮、光标位置、折叠状态完全不同步，协作者看到的是“裸文本”，不是真实编辑上下文
实操建议：避免多人编辑同一文件；若必须，限定每人只改函数块，并在修改前执行 Floobits: Save and Sync（该命令强制全量推送到服务端）。
如何验证 Floobits 当前是否真正在同步
不要依赖界面右下角的 “Floobits Connected” 提示——它只表示 TCP 连接建立成功，不保证数据通道可用。
有效验证方式只有两个：
- 打开两个 Sublime 实例（A 和 B），在 A 中修改某行末尾加
// test-$(date +%s)，保存后等待 3 秒，立刻切到 B 查看该行是否更新；若未变，说明同步链路中断 - 在终端运行
tail -f ~/.floorc.json.log（日志路径由插件动态生成），观察是否有POST /api/v1/buffers/xxx/patch成功响应；失败时通常只打印HTTP Error 502或空行
注意：~/.floorc.json.log 默认不开启，需先在 Floobits 设置中启用 "debug": true 并重启 Sublime。
替代方案比硬扛 Floobits 更省时间
如果你需要的是「能落地的结对编程」，而不是「在 Sublime 里坚持用 Floobits」，以下路径实际损耗更低：
- 用
code-server容器跑 VS Code，通过反向代理暴露 HTTPS 端口，所有人访问同一地址 —— 光标、终端、调试器全同步，且 Sublime 用户几乎零学习成本 - 项目根目录下放
.vscode/settings.json，配好editor.fontFamily和sublimelinter类似插件，让 VS Code 看起来像 Sublime - 保留 Sublime 作离线主力，仅在需要结对时开浏览器进
code-server，用Ctrl+P快速跳转到同名文件，无需迁移整个工作流
真正的难点从来不是“怎么装 Floobits”，而是当三人同时改 utils.py 且其中一人网络抖动 800ms 时，你手头没有可回滚的 OT 日志，也没有服务端操作队列快照 —— 这些缺失的设计，不是改几个配置项能补上的。
