Live Share卡在“Waiting for host”主因是中继服务连接失败，需检查扩展启用状态、运行诊断命令、配置备用中继地址，并确保双方使用stable版VSCode≥1.80且正确启用扩展。
Live Share 是目前唯一能实现在 VSCode 里「多人同步编写」的可靠方案，但它不是“自动实时同步所有编辑”，而是依赖手动保存、权限控制和网络中继协同工作的会话系统。用错方式或忽略环境约束，协作会卡在连接、不同步、光标消失或终端不可用等环节。
Live Share 连接卡在 “Waiting for host” 怎么办
这不是你网速慢，而是 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。
- 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防误删
最常被忽略的一点：Live Share 的协作粒度由 Host 主动控制，不是“开了插件就自动同步一切”。从连接诊断、Workspace 共享、保存习惯到调试环境一致性，每个环节都存在隐式前提。别把协作失败归咎于网络或插件，先查状态栏图标、诊断日志、共享模式和本地环境是否对齐。
