VSCode实时协作需Live Share扩展+命令面板启动会话+显式权限配置三者协同:必须安装启用微软官方扩展,通过Ctrl+Shift+P执行“Live Share: Start Collaboration Session”,并勾选终端等共享权限,否则无法触发协作功能。

VSCode 实时协作不是开个开关就能用的功能,它依赖 Live Share 扩展 + 明确的会话启动方式 + 权限配置三者协同。直接装完扩展不操作命令面板,Live Share: Start Collaboration Session 就不会触发,终端和调试也不会共享。
必须安装并启用 Live Share 扩展
这是所有协作功能的基础,没有它,其他设置全是空谈。VSCode 市场里搜 “Live Share”,认准微软官方出品(Publisher: Microsoft),安装后无需重启,但必须确保它处于启用状态(右下角状态栏能看到 Live Share 图标亮起)。
- 别和
Remote Development插件混淆——后者管远程连接(SSH/WSL/Codespaces),不负责多人实时编辑或聊天 - 如果已安装但命令面板搜不到
Live Share: Start Collaboration Session,检查是否被禁用,或尝试重装扩展 - 企业环境中若插件被策略屏蔽,需联系管理员确认
liveShare.enabled是否设为true
启动协作会话必须走命令面板,不能靠点击图标
很多人点左侧面板的 Live Share 图标,只看到“Join Session”或空白页,是因为主机端没真正创建会话。正确路径是:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并选择 Live Share: Start Collaboration Session。
- 执行后会弹出权限选择菜单:默认是
Read/Write,如需限制访客只能看代码,选Read Only - 终端共享需额外勾选
Allow guests to use the terminal,否则即使会话开启,对方也进不了终端 - 生成的链接带加密 token,有效期默认 24 小时;若设为
private模式,链接仅对组织内登录用户有效
终端共享失败?检查 terminal 权限和远程环境兼容性
共享终端看起来最简单,但实际最容易卡住。常见现象是访客点击终端标签页后一片空白,或提示 “The terminal process failed to launch”。这不是网络问题,而是权限或环境缺失。
- 主机启动会话时,必须在权限配置中显式开启
terminal写入权限,即配置项"terminal": "write"要存在且为"write" - 如果主机用的是 WSL 或 Remote-SSH,访客终端默认继承主机 shell 环境,但某些发行版(如 Alpine)缺少
/bin/sh符号链接,会导致终端无法启动 - Windows 主机上,PowerShell 终端共享可能因执行策略(
ExecutionPolicy)阻止脚本加载,建议临时切到Command Prompt启动会话测试
真正容易被忽略的是:协作会话中的终端不是“镜像”,而是主机进程的直接接入。这意味着访客执行 npm install 或 git pull,操作结果实时反映在主机文件系统上——如果你没提前备份,误删或覆盖就不可逆。











