live share默认只读,协作者无法保存;需主机在命令面板执行“live share: change guest permissions”授权编辑权限,或全局设"liveshare.allowediting": true(不推荐对外协作者)。

能直接用,但默认权限是只读,不手动开编辑权,协作者连保存都做不到。
Live Share 扩展安装与基础启动
VSCode 里启用实时协同编码,第一步就是装 Live Share 扩展——它不是内置功能,必须手动安装。装完后不能直接点“共享”,得先打开一个具体项目文件夹(比如含 package.json 或 src/ 的目录),否则会弹提示“请先打开工作区”。
- 快捷键
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Live Share: Start Collaboration Session启动 - 状态栏左下角出现小人图标,点击也能快速唤起会话控制面板
- 生成的链接带一次性 token,有效期默认 24 小时,过期后需重新生成
协作者默认只有只读权限,编辑需主机主动授权
新加入的访客(Guest)默认是 "liveshare.allowEditing": false,哪怕你看到光标在对方屏幕上移动,他敲字也不会写入文件——这是安全设计,不是 bug。
- 主机可在命令面板运行
Live Share: Change Guest Permissions,为指定用户切换只读 / 编辑 / 主持权限 - 也可在设置中全局修改:
"liveshare.allowEditing": true,但不推荐,尤其面对外部协作者时 - 权限变更实时生效,无需刷新或重连,但对方编辑器右下角会弹出提示确认
网页版 vs 桌面版协作的兼容性陷阱
vscode.dev 网页版支持 Live Share,但终端共享、调试会话、本地服务器转发(Share Server)这三项功能在浏览器中不可用——这些依赖桌面端 Node.js 运行时和系统级网络能力。
- 如果协作者从链接跳转到网页版,而你需要共享
npm run dev终端或断点调试,务必提前告知对方安装桌面版 VSCode - 桌面端用户点击网页链接后,可用
Live Share: Open in VS Code命令一键跳转,前提是已安装且关联了协议 - 网页端访客无法发起
Share Terminal,但能查看主机共享的终端输出(只读)
调试会话同步失败的常见原因
多人同时看到断点、变量值和调用栈,前提是主机启动的是 VSCode 内置调试器(如 Node.js、Python),且调试配置没用到绝对路径或本地环境变量。
- 检查
launch.json中的program路径是否用了${workspaceFolder},避免硬编码C:\project\...或/home/user/... - 若调试器依赖本地 CLI 工具(如
jest、phpstan),确保所有协作者机器上已全局安装同版本 - 主机启动调试后,访客需手动点击调试侧边栏的“Resume”按钮才能同步进入运行态,不是自动接管
最易被忽略的点:权限开关藏在命令面板里,不在右键菜单或状态栏图标长按菜单中;另外,网页端用户永远看不到“调试”和“终端”两个共享开关,这点必须提前对齐预期。











