VSCode多人实时协作需启用Live Share会话：必须安装官方扩展、登录账号、打开项目目录；启动时手动勾选共享终端、调试、本地服务；默认仅共享编辑器内容，权限无记忆性，每次会话均需重新配置。
直接开启 VSCode 多人实时协作编程，核心就是启用 Live Share 会话——它不是“连上 Git”或“共享屏幕”，而是让多人在同一工作区里同步编辑、调试、跑终端，且所有操作默认端到端加密、延迟低于 120ms。
确认 Live Share 扩展已安装并登录账号
没装扩展或没登录，点任何“开始协作”都会静默失败，连错误提示都不给。
- 必须安装官方
Live Share扩展（Microsoft 出品），别用第三方仿制品 - 登录方式只认
Sign In With Browser：点击左下角小人图标 → 选浏览器登录 → 支持 Microsoft 账户或 GitHub 账户 -
Sign In With User Code在 2026 年多数环境下已失效，别试 - 若团队有安全要求，可在
settings.json中强制认证："liveshare.authentication.enabled": true
启动协作会话前必须打开一个项目目录
VSCode 不允许在空窗口或单文件模式下启动 Live Share——它共享的是“工作区”，不是“文件”。弹出“Please open a folder first”就说明你卡在这一步。
- 用
File → Open Folder...打开含.git或package.json等标识的完整项目目录 - 不能只打开一个
index.js就点 Start Collaboration Session - 启动后生成的链接带会话 ID 和加密签名，有效期默认 7 天（可配置）
- 命令行也可触发：
npx @vsliveshare/cli start，适合 CI/CD 集成场景
权限控制不设默认值，必须手动确认共享范围
很多人以为“点一下就共享全部”，结果访客进来看不到终端、调不了调试器、连本地 live-server 都访问不了——因为默认只共享编辑器内容。
- 启动会话时弹出的选项框里，必须主动勾选：
Share Terminal、Share Debug Sessions、Share Local Server（比如vscode-live-server的 5500 端口） - 主机可随时通过命令面板执行
Live Share: Change Guest Permissions动态开关权限 - 若用
vscode-live-server，需确保它已安装且“Go Live”按钮已激活——Live Share 检测到该服务运行中才会自动透传端口 - 细粒度控制写在
settings.json里："liveshare.allowEditing": false表示默认禁止编辑，须主机批准
访客加入后看不到代码？检查网络与角色状态
链接能打开、VSCode 实例也起来了，但编辑器一片空白或只显示文件树——大概率是角色权限或网络穿透问题。
- 访客加入后默认是
Guest角色，若主机没勾选Allow Editing，文件将锁定为只读，且无法展开折叠区域 - 企业内网或某些云开发环境可能屏蔽 WebRTC 3.0 的 UDP 流量，导致同步卡在“connecting…”；此时需主机在设置中启用
"liveshare.forceRelay": true切回 TCP 中继（延迟升至 ~300ms） - 访客无法主动退出会话影响主机，但主机执行
Live Share: End Session后，所有连接立即断开，终端进程终止 - 别依赖状态栏小人图标是否“亮起”来判断连接状态——它有时不刷新，用命令面板查
Live Share: Show Session Details更准
真正容易被忽略的是：协作不是“开了就完事”，而是每次会话都得重设终端权限、重授权调试、重新暴露本地服务端口。这些动作没有记忆性，也不会继承自上一次会话——你得把它当成每次启动都要手动过一遍的 checklist。
