VSCode如何利用扩展实现协作式同步编写_VSCode远程协同指南【协作】-VSCode-PHP中文网

live share卡在“waiting for host”主因是中继服务连接失败，需检查扩展启用状态、运行诊断命令、配置备用中继地址，并确保双方使用stable版vscode≥1.80且正确启用扩展。

vscode如何利用扩展实现协作式同步编写_vscode远程协同指南【协作】

Live Share 是目前唯一能实现在 VSCode 里「多人同步编写」的可靠方案，但它不是“自动实时同步所有编辑”，而是依赖手动保存、权限控制和网络中继协同工作的会话系统。用错方式或忽略环境约束，协作会卡在连接、不同步、光标消失或终端不可用等环节。

这不是你网速慢，而是 VSCode 没连上微软中继服务 prod.liveshare.vsengsaas.visualstudio.com —— 常见于企业防火墙、DNS 污染、代理拦截或扩展未启用。

先看右下角状态栏有没有亮起的 Live Share 图标（非灰色），没亮说明扩展没启用，点开扩展面板找到 ms-vsliveshare.vsliveshare 手动点 Enable
按 Ctrl+Shift+P 输入 Live Share: Show Connection Diagnostics，看输出里是否出现 Failed to connect to relay server 或 WebSocket connection failed
若确诊是中继不通，进设置搜 liveshare.relayUrl，临时改成 https://insiders.liveshare.vsengsaas.visualstudio.com（比默认地址更少被拦截）
禁用所有 Remote 类扩展（如 Remote - SSH、Remote - Containers），它们会抢占 WebSocket 端口，导致邀请链接点击后报 Join session failed
双方必须都用 VSCode Stable 渠道（非 Insiders），且版本 ≥ 1.80；旧版对 TLS 1.3 握手支持不一致，静默失败无提示

Live Share 默认只共享「当前打开的文件」，不是整个工作区——这是设计，不是 bug。Host 不主动共享目录，Guest 就只能看到一个孤零零的 tab。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

Host 必须点击右下角 Live Share 状态栏 → Share Workspace（不是 Share Current File），才能让 Guest 看到完整文件树并自由导航
如果已共享 Workspace，但 Guest 仍看不到某些文件，检查 Host 是否打开了 .gitignore 里排除的路径（如 node_modules），Live Share 默认不推送被 Git 忽略的文件夹
Guest 加入后切换分支、拉新代码、改 .gitignore，这些操作不会同步——Live Share 不监听 fs 事件，只转发编辑动作。需要 Host 手动 git pull 后再保存文件，Guest 才能看到变更
避免用企业微信/钉钉发邀请链接，它们可能截断 https://prod.liveshare.vsengsaas.visualstudio.com/ 中的域名，导致链接失效

Live Share 共享的是「编辑会话状态」，不是字符流，所以没有真正意义上的“实时键入同步”。延迟、覆盖、撤销不同步是常态，不能靠工具规避，得靠协作习惯补位。

修改后务必按 Ctrl+S 保存——Live Share 不自动推送未保存内容。可设 files.autoSave 为 afterDelay 或 onFocusChange 来降低遗漏概率
多人同时改同一行时，后提交的编辑会直接覆盖前者，且无冲突提示。不要并行重写函数体，建议用语音/聊天窗口提前约定修改范围
Guest 的撤销栈（Ctrl+Z）只作用于自己本地视图，和 Host 的撤销历史完全隔离。想回退到协作前状态，得 Host 手动 git checkout 或从快照恢复
editor.cursorSmoothCaretAnimation 和 editor.multiCursorMergeOverlapping 能改善光标视觉反馈，但不解决底层同步逻辑

终端是本地进程，调试器依赖本地 launch.json 和运行时环境——Live Share 只转发“操作意图”，不复制执行上下文。很多问题本质是环境差异，不是插件缺陷。

Live Share 默认不共享终端；需 Host 右键终端面板 → Share Terminal，但仅共享只读输出，Guest 无法输入命令
调试时，launch.json 中的 program 路径、env、cwd 全部使用 Guest 本地配置。Host 写着 "program": "./out/index.js"，Guest 本地没这个路径就直接 attach 失败
Node.js 版本差一个 patch、Python 虚拟环境路径不一致、端口被占用，都会导致断点灰掉或调试器启动失败——比编辑不同步更难定位
敏感操作如终端执行、调试启动，默认需 Host 主动授权；可在设置里关掉 liveshare.allowGuestCommandExecution 防误删