VS Code实时协作需通过Live Share插件建立加密会话，主机发起、来宾加入，编辑直接落盘主机；启动前必须打开项目根目录，否则命令不可用；登录仅支持浏览器方式（MS/GitHub账号），不支持User Code；默认共享文件、终端、调试器，但只读模式、路径限制（.vsls.json）、环境差异（shell/路径变量/防火墙）及主机稳定性均影响协作效果。
VSCode实时协作不是“打开就多人写”，而是靠 Live Share 扩展建立加密会话，主机发起、来宾加入，所有编辑直接落盘到主机机器——没 Git 提交、没文件传输、也不依赖共享服务器。
怎么启动一个可编辑的协作会话
必须先确保项目已打开（即工作区有根目录），否则 Live Share: Start Collaboration Session 命令会报错或灰掉。启动后 VSCode 左下角会出现小人图标，点击即可复制链接；也可用命令面板快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调出。
- 链接默认带端到端加密，无需额外配置 TLS 或反向代理
- 若提示“未登录”，必须用
Sign In With Browser方式完成 Microsoft 或 GitHub 账户认证（Sign In With User Code在多数环境下不可用） - 启动瞬间会自动启用文件共享、调试器和终端——除非你手动在
settings.json里关掉某项，例如："liveshare.gitIntegration": false
来宾加入后为什么不能改代码
常见现象是：来宾能看见光标、能跳转、能查看变量，但敲键盘没反应，保存也无效。这通常是因为主机启用了只读模式，或来宾权限被策略限制。
- 检查左下角状态栏是否显示
Read-only session—— 若有，主机需在共享面板中点击“Toggle Read-Only”解除 - 主机可通过
.vsls.json文件显式控制来宾可访问路径，例如："files": ["src/**", "tests/**"]，漏配会导致部分文件对来宾不可见或不可编辑 - 若使用了组织级策略（如企业版 Live Share），
"liveshare.allowAnonymousGuests": false可能强制要求身份绑定，未认证的来宾会被降级为只读
终端和调试器共享失败的三个典型原因
Share Terminal 和 Share Server 功能看似一键开启，实际常卡在环境隔离或权限链路上。
- 终端共享失败：主机终端当前运行的是
zsh或fish，但来宾机器没装对应 shell，会 fallback 到bash并中断连接；建议统一用bash启动终端再共享 - 调试器无法同步断点：主机 launch.json 中的
cwd路径是绝对路径（如/home/user/project），而来宾机器结构不同，导致路径解析失败；应改用${workspaceFolder}这类变量 - 本地服务转发（如
Share Server）失败：主机防火墙或公司网络策略可能拦截了 Live Share 动态分配的临时端口（范围通常为 32768–65535），需确认该端口段未被阻断
真正容易被忽略的点是：所有协作操作都发生在主机的文件系统上，来宾没有本地副本。这意味着主机一旦退出 VSCode、断网、或手动终止会话，所有来宾将立即失去连接且未保存的编辑会丢失——没有“离线缓存”机制，也没有自动回滚。协作前务必确认主机稳定性，别在临发布前拉人进会话。
