Live Share 是 VSCode 官方实时协作功能，须从官方市场安装 Microsoft 发布的蓝白双环插件；需 VSCode 1.60+、登录微软账户、正确打开文件夹、确保网络可达 vscode.live-share.com 并授权系统权限。
Live Share 插件安装失败或找不到入口？
VSCode 官方实时协作功能由 Live Share 提供，不是第三方插件，必须从官方扩展市场安装。常见错误是搜索“实时协作”“多人编辑”等关键词，结果装了非官方替代品（如旧版 CodeTogether 或已停更的 Teletype），导致无法登录或功能缺失。
正确做法是：打开扩展面板（Ctrl+Shift+X / Cmd+Shift+X），直接搜索 Live Share，认准发布者为 Microsoft、图标带蓝白双环标识的官方插件。安装后无需重启，但首次使用需登录微软账户。
- 若搜索不到，检查 VSCode 是否为 1.60+ 版本（2026 年所有稳定版均满足）
- 企业网络可能屏蔽
vscode.live-share.com域名，此时需联系 IT 开放该域名或改用代理 - 安装后状态栏不会立即出现按钮——要先打开一个文件或文件夹，
Live Share才会激活并显示“Share”图标
登录失败：OAuth 跳转打不开或提示“Invalid redirect_uri”
这是最常卡住的环节。Live Share 依赖 VSCode 内置的 OAuth 流程，但部分系统环境会破坏重定向链路：
- Windows 上启用了“Windows Defender SmartScreen”或第三方安全软件拦截了 VSCode 的本地回调地址（
vscode://vsls-auth/） - macOS 上未授予 VSCode “辅助功能”权限（系统设置 → 隐私与安全性 → 辅助功能 → 勾选 VSCode）
- Linux 下未安装
xdg-open或桌面环境不支持 URI handler（可临时在终端运行xdg-open "vscode://vsls-auth/..."测试）
绕过方式：点击登录按钮后，当浏览器弹出“正在重定向…”页面时，手动复制地址栏中以 vscode://vsls-auth/ 开头的完整 URL，粘贴到 VSCode 的命令面板（Ctrl+Shift+P）中执行 Developer: Open URL，即可强制完成回调。
共享项目时提示“Guest can’t join: missing permissions”
协作失败往往不是插件问题，而是权限链断裂。Live Share 默认只共享当前打开的文件夹（workspace），但以下情况会导致访客看不到内容：
- 你打开的是单个文件（如
index.html），而非整个项目文件夹 —— 访客只能看到该文件，无法浏览目录结构 - 项目根目录下缺少
.vscode/settings.json或.git，Live Share 会降级为“文件级共享”，禁用调试、终端等高级功能 - 你使用了远程开发（SSH/Containers），而访客未安装对应远程扩展，此时需提前告知对方安装
Remote - SSH或Dev Containers
验证是否正常：启动共享后，右下角状态栏应显示“Sharing [folder-name]”，且鼠标悬停可见“Copied invite link”；访客点击链接后，VSCode 应自动打开并加载相同路径结构，而非空白窗口。
为什么邀请链接打不开，或访客加入后无响应？
根本原因通常是网络穿透失败。Live Share 默认走微软中继服务器，但若双方都在严格 NAT 后（如公司防火墙、校园网），中继可能超时。
关键排查点：
- 检查 VSCode 设置中
"liveshare.allowUntrustedCertificates"是否设为true（仅限内网可信环境） - 在命令面板运行
Live Share: Show Connection Diagnostics，查看日志里是否出现Failed to connect to relay - 临时关闭本地防火墙（特别是 Windows Defender 防火墙的“专用网络”规则）再试
真正稳定的协作场景，建议始终确保主机端有公网 IP 或至少能直连互联网 —— 这不是插件缺陷，而是 P2P 协作协议的物理限制。
