live share 在 vscode 中需用“live share: start collaboration session”命令启动才能正常协同编辑、终端共享与调试同步；误用其他命令会导致功能异常，且须注意防火墙授权、扩展禁用、包管理器一致性、调试配置（如 address: "0.0.0.0"）及剪贴板等非代码内容不共享。
Live Share 在 VSCode 中能实现实时协同编辑、终端共享、调试同步，但默认配置下容易卡顿、权限错乱或连不上——关键在启动方式和角色分工。
启动 Live Share 会话必须用 Live Share: Start Collaboration Session
不是点右下角状态栏图标（那只是打开面板），也不是用快捷键 Ctrl+Shift+P 搜 “Live Share” 后随便选一个命令。只有这个明确命名的命令才会初始化完整的协作上下文，包括服务端注册、端口映射和身份令牌生成。
- 如果误用了
Live Share: Join Collaboration Session自己发起会话，对方将无法看到你的终端或调试器 - 首次启动时 VSCode 会弹出系统级防火墙提示，必须允许；跳过会导致后续所有共享功能（如
localhost:3000）对协作者不可访问 - 启动后状态栏显示 “Sharing” 并带有一个链接，这个链接含一次性 token，24 小时后自动失效，不建议手动复制修改
协作者加入时要禁用本地扩展干扰
Live Share 默认只同步工作区代码和调试配置，但某些扩展（比如 ESLint、Prettier、GitLens）会在加入瞬间触发本地校验逻辑，导致编辑卡顿甚至光标不同步。
- 加入前在命令面板运行
Live Share: Toggle Guest Extension Activation，关闭非必要扩展 - 特别注意禁用任何依赖本地 node_modules 的 LSP 扩展——协作者没装对应包，
typescript-language-server会反复报Failed to start language server - 如果项目用了
pnpm或bun，务必提前告知主机方，Live Share 不自动同步包管理器版本，执行npm run dev可能因解析器不匹配直接退出
liveShare.host 配置影响调试器能否同步断点
VSCode 默认把调试器控制权交给主机，但如果你在 launch.json 里写了 "port": 9229 且没设 "address": "0.0.0.0"，协作者连不上 Node.js inspector。
- Node.js 调试需在主机的
launch.json中显式添加："address": "0.0.0.0"和"sourceMaps": true - Python 用户要注意：仅当使用
ptvsd或debugpy且启用"justMyCode": false时，协作者才能跨文件跳转到虚拟环境里的库源码 - 浏览器调试中，主机打开的是
http://localhost:5173，协作者看到的仍是同一地址——Live Share 不代理 HTTP 流量，所以 HMR 热更新不会同步到对方浏览器
最常被忽略的一点：Live Share 不同步剪贴板、不转发系统通知、也不共享音频/摄像头。想边写边讲，得额外开 Zoom 或 Teams——它只管“代码层”的实时性，别的都得自己搭管道。
