三人三地第一次连线写代码,我踩完了 Zed 协作的所有坑
三人三地第一次连线写代码,我踩完了 Zed 协作的所有坑
上周五晚上十点,我在北京,同事一个在杭州,一个在家里蹲着改 bug。
我们决定试试 Zed 的实时协作——三个人,同一个项目,你敲一行我改一行,光标在屏幕上互相追着跑。
听起来像科幻片。实际前二十分钟,我们经历了:谁连不上、谁只能看不能改、谁的光标一直跟着别人乱飞。
这篇就把我们踩的坑按顺序摊开讲,你如果准备拉队友第一次连线,可以少走一半弯路。
一、这是啥?一句话:把"结对写代码"搬进了编辑器
先给不熟悉的朋友补一句。
Zed 是一款开源的代码编辑器,出自 Atom 和 Tree-sitter 的作者团队,用 Rust 从零重写,不是套壳浏览器那一类,开大项目不转圈、滚动不掉帧,这两年社区里一直有人喊它"VS Code 最强挑战者"。
它最特别的地方,是把多人协作做成了内置功能,而不是装个插件凑合。
打个比方:别的编辑器协作像"你把文件发我、我改完发你",中间靠微信传;Zed 更像几个人围着同一张桌子写字,谁的手在哪、笔尖停在哪一行,全场都看得见。
打开方式也很朴素:右上角登录(走 GitHub 授权,只读你的公开资料),左侧拉出协作面板,里面有两条路——
- 频道(Channels):长期存在的"房间",适合一个团队、一个项目常驻;
- 联系人 + 私聊:临时抓一个人连线,适合"你帮我看一眼这个报错"。
我们第一次选了频道,因为想顺便开语音。
二、坑一:网络——不是你网速差,是门没开
第一个报错来自杭州的同事:登录转圈,房间进不去。
我们一度怀疑他家宽带。后来才反应过来——他挂着公司 VPN。
这里有个很多人第一次会忽略的点:Zed 的协作是走它自己的服务端的,公司网络如果只放行了常用域名,就会卡在门口。文档里写得很直白:要确保能连上 zed.dev 和 collab.zed.dev。
说人话就是:你把小区门禁卡给了对方,但没给单元门的。
关掉 VPN 后,人进来了。接着我们做了个"故意作死"测试:我在共享网络下把 Wi-Fi 关了 10 秒再打开。
结果有点惊喜——它自己爬回来了。Zed 的断线重连是"半秒起跳、逐次翻倍、最长隔 30 秒试一次",房间这边还留了大约 30 秒的重连窗口和几次重试机会。
换成大白话:你手抖断个网、切个 Wi-Fi、笔记本休眠醒过来,多数情况下不会散伙,光标回来还在原位。
但要是断得久——比如你把电脑合盖去泡了碗面——那就真掉线了,得重新进房间。
第一次连线建议:全员先关掉 VPN 和企业代理试一次,能连上再谈别的。这一条能省掉 80% 的"玄学报错"。
三、坑二:权限——你分享的不是代码,是你电脑里那个文件夹
这是整晚最需要我们停下来认真讲的一件事。
Zed 的协作模式是:谁点了"分享项目",谁的电脑就是那台"服务器"。别人看到的文件,其实长在你的硬盘上,只是在他们的窗口里被"远程投影"了出来。
所以官方文档第一句警告就很重:分享项目,等于让对方在你这个项目范围内访问你的本地文件系统,只跟你信任的人连线。
理解了这一点,权限那套设计就顺了:
1)新人进频道,默认是"只读观众"
他能看、能听、能跟着你的光标跑,但改不了代码。想让他动手,需要房主右键给他开"允许写入"——开了之后他才能编辑、开麦、共享屏幕。
这就像一个直播间:观众能看能刷弹幕,但想上台得主持人递话筒。
2)公开频道 = 全世界都能进来围观
频道可以设成公开,任何人点链接就能进。这种模式下,他们是纯观众:能听见你们说话、看见你们屏幕,写入权限依然没有。
如果你要直播写代码、或者给一群人做演示,这个模式很合适;但如果你在改公司项目,千万别手滑点公开。
3)子频道的权限是"继承"的
你在顶层频道加了人,他自动拥有下面所有子频道的通行证。方便,但也意味着——别把不相干的人加在顶层。
4)收回权限只有一个动作:停止共享
房间右上角点"取消共享",正在里面的人会被直接断开,而且除非你重新分享,否则进不来。
这个设计很干脆,我们试完的感受是:比"踢人"更彻底,也更适合"聊完了,收工"这种场景。
顺带说个冷知识:频道还自带一个共享的 Markdown 笔记页,可以写"今天改到哪了、下一步做啥",甚至不加入频道也能看。我们那晚的会议纪要就扔在那儿,比另开文档舒服。
四、坑三:光标打架——被"跟着你跑"支配的恐惧
前两个坑是配置问题,第三个坑是体验问题,也是最好笑的部分。
人一进来,Zed 默认让我自动跟随邀请我的人。于是我的画面开始不受控制:他翻到哪个文件,我就跟到哪个文件;他滚到第 800 行,我也被拽过去。
我当时的第一反应是:我鼠标坏了?
其实这是设计。跟随是"按窗格"生效的——你正在跟随某人的那个窗格,会描上一圈对方光标颜色的边框,等于告诉你"这块屏幕现在不归你管"。
想脱离控制非常简单:动一下鼠标,或者随手敲一个字,跟随立刻解除。
搞清楚这一点之后,画面就变得很美妙了:
- 同一个项目里的人,头像是彩色的,每个人有自己专属的光标颜色;
- 不在这个项目里的人,头像是灰色的,一眼区分;
- 你可以一个窗格跟着他看他改,另一个窗格自己翻自己的文件,互不干扰。
至于"两个人同时改同一行会不会打架"——我们特意试了。我删他正在打的那行,他那边立刻看到我的改动,光标被"顶"到了新的位置。
它不是等你保存才合并,也不是弹窗问你"文件已被修改,是否覆盖",而是像两个人共用一支笔,谁先落笔谁的痕迹就在那,另一人自动让位。
顺带提一句:终端窗口目前不支持同样的"跟随",想一起看命令输出,只能共享屏幕。
五、踩完坑之后,真香的地方在哪
坑归坑,但那天晚上我们的效率确实上来了。
以前排查一个线上问题,流程是:截图 → 发群里 → "你打开那个文件" → "第几行" → 再截图。来回七八轮,二十分钟过去了。
那天是:他直接跟着我的光标看,看到可疑处直接说"往上翻两行",然后他自己动手改,我这边实时看到 diff 一行行冒出来。沟通成本被砍掉了大半。
还有几个细节挺加分:
- 别人的项目在你这边打开,你用的还是自己的配置:主题、快捷键、AI 补全、跳转定义都能用,不会因为"在别人电脑上"就变成陌生人;
- 语音是内置的,进频道默认开麦(怕吵可以设置成"进房静音"),还能单独选输入输出设备、点一下"测试音频"确认麦克风没坏;
- 共享屏幕可以选具体哪块屏,多显示器的人不用尴尬地"整块桌子都播出去"。
顺便说一句舆情背景:Zed 这两年在开发者社区热度一直很高,掘金上"Zed 有望打败 VS Code 吗"这种帖子动辄近十万阅读,CSDN 上也有人写"放弃 VS Code"的使用感受。讨论最多的两个点,一个是"快",另一个就是原生协作——不是插件拼出来的,是长在骨子里的。
六、普通人要不要试?门槛比想象中低
先说结论:不需要高配显卡,也不需要服务器。
它就是个正常软件,装完能打字就能用;不登录也能当普通编辑器使,只有协作和官方 AI 服务需要登录。协作那台"服务器"就是房主的电脑,你不需要另外租机器。
适合谁?
- 远程办公的小团队:每天站会改成"一起进频道看进度",比开会高效;
- 带新人的老手:他写,你跟着看,看到问题直接上手改两笔,比事后 code review 更及时;
- 做技术直播或教学的人:公开频道 + 屏幕共享,观众只读围观,不怕被搞乱;
- 临时求助:加个联系人,一键拨过去,"你帮我看看这段"。
唯一要记住的红线:分享项目 = 分享你硬盘上的那个文件夹。只跟信任的人连,聊完记得点"取消共享"。
写在最后
那天我们散场时是凌晨一点。三个人,三个城市,一个项目,全程没建过一次群聊、没发过一张截图。
技术最好的地方,从来不是参数有多猛,而是它悄悄把一件麻烦事变成了不需要解释的日常。
所以我挺好奇:如果协作写代码像打开一个网页房间一样简单,你最先想拉上谁一起干活?是那个总说"你把代码发我"的队友,还是总在群里喊"在我这能跑啊"的朋友?
评论区聊聊,你的第一次"云同桌"经历是什么样的。