访客无法加入VSCode Live Share会话，主因是身份验证未完成或客户端跳转失败；点击链接后需通过网页版左上角“汉堡”菜单或左下角Live Share按钮选择Open in VS Code切回桌面端，并确保已安装插件、账户登录一致且禁用广告拦截器。
访客无法加入 VSCode Live Share 会话，绝大多数情况不是链接问题，而是身份验证或客户端跳转路径没走对——尤其在浏览器打开链接后卡在“Join as Guest”页面却无响应时，本质是未触发桌面客户端自动唤醒或未完成账户绑定。
点击邀请链接后只看到网页版编辑器，怎么进桌面端？
VS Code 的 vscode.dev 网页版默认优先加载，但 Live Share 会话本身不支持完整功能（如调试、终端共享、扩展依赖）。必须切回桌面客户端才能真正协作。
- 在网页版编辑器左上角点“汉堡”菜单 → 选
Open in VS Code（不是“Open in Browser”） - 或点左下角绿色
Live Share状态栏按钮 → 弹出菜单选Open in VS Code - 如果桌面端已运行但没自动唤起，检查是否已安装 Live Share 扩展；未安装会导致跳转失败，仅停留在网页页
- macOS 用户若用 Apple Silicon，确认桌面版 VS Code 是原生 ARM64 构建版本，否则可能因架构不匹配拒绝连接
“Join as Guest”点击无反应或报错 Failed to join session
这个错误几乎都指向身份认证环节中断。Live Share 要求所有参与者（包括访客）至少完成一次 GitHub 或 Microsoft 账户登录，且该账户需启用双重验证（2SV）——即使你选“Continue as Guest”，底层仍会尝试绑定匿名会话 ID 到临时账户，失败即阻断。
- 先在桌面端 VS Code 中手动登录：打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Live Share: Sign In - 确保浏览器中登录的 GitHub/Microsoft 账户与 VS Code 设置里显示的一致（可通过
Live Share: Account Settings查看） - 禁用广告拦截插件（如 uBlock Origin），它们常误杀 Live Share 的信令 WebSocket 请求（
wss://prod.relay.liveshare.vsengsaas.visualstudio.com/） - 企业网络环境下，检查是否拦截了
*.liveshare.vsengsaas.visualstudio.com域名
访客加入后看不到文件、断点或终端，但主机端一切正常
这不是同步延迟，而是权限配置或扩展兼容性问题。Live Share 默认只共享“当前工作区根目录下的文件”，不会自动加载主机全局安装的扩展，也不会继承主机的 settings.json 配置项（除非显式开启）。
- 主机启动会话前，确认项目已通过
File → Open Folder...正确加载为工作区（而非单个文件），否则访客看到的是空工作区 - 访客端需手动安装与主机相同语言的扩展（如 Python、ESLint），否则语法高亮、LSP 功能失效
- 检查主机是否关闭了关键共享项：在状态栏右键
Live Share按钮 →Sharing Options→ 确保Share terminal、Share debugging sessions已勾选 - 若主机使用了自定义
launch.json，需确认其中的port、address字段未设为localhost（应改为0.0.0.0或留空，否则访客无法访问调试服务）
为什么访客能编辑文件却无法启动调试或执行终端命令？
Live Share 的权限模型是分层控制的，默认访客只有 ReadWrite 文件权限，但调试和终端属于高危操作，默认禁止。主机必须显式授权，且该授权不能通过 URL 传递，只能在会话启动后动态调整。
- 主机在会话中右键点击访客头像（位于编辑器右上角）→ 选择
Change Guest Permissions→ 勾选Debug或Terminal - 注意：
Debug权限 ≠ 允许访客设置断点，而是允许其触发F5启动调试会话；断点本身是实时同步的，无需额外授权 - 终端命令执行受
liveshare.terminalSharing设置控制，该值需在主机的settings.json中设为true，且不能被工作区设置覆盖 - 访客执行
npm run dev类命令失败，常见原因是主机终端用了 zsh/fish 而访客是 bash，环境变量或别名不一致；建议统一用script -qec "npm run dev" /dev/null包装命令规避 shell 差异
最易被忽略的一点：Live Share 不同步主机的本地进程状态（比如已运行的 nodemon 或数据库服务），访客看到的只是“可连接的终端窗口”，而非真实运行中的服务实例。需要主机手动共享端口或提前暴露服务到局域网 IP。
