VSCode Live Share 通过安装官方扩展、登录账号、打开文件夹项目后启动协作会话,生成加密链接共享本地工作区(含终端、调试器、本地服务),权限选项决定共享范围,链接过期自动失效,主机退出则会话终止。

直接分享项目,不是靠“复制整个文件夹”或“传压缩包”,而是启动一个 Live Share 会话,让对方实时接入你的本地工作区——所有文件、终端、调试器、甚至正在跑的 live-server 都可按需共享,且修改只保留在你本机。
必须先装扩展并登录账号
没装 Live Share 扩展,Start Collaboration Session 命令根本不会出现在命令面板里。它不是 VS Code 内置功能,而是由 Microsoft 维护的独立扩展。
- 在扩展市场搜
Live Share,安装官方版本(发布者是Microsoft) - 启动后必须登录:支持
Microsoft Account或Github账号;Sign In With User Code在新版中已失效,务必选Sign In With Browser - 未登录状态下点击左下角小人图标,只会弹出登录提示,不会生成链接
分享前要打开一个真实项目目录
Live Share: Start Collaboration Session 命令要求当前 VS Code 是以**文件夹方式打开项目**(即工作区有根路径),不能是单文件打开或空窗口。否则会报错:“No folder opened” 或弹窗提醒“请先打开一个文件夹”。
- 正确姿势:
File → Open Folder...选中含package.json、src/或.git/的目录 - 错误姿势:只打开
index.js单文件,或新建空白窗口后直接调命令 - 如果项目结构复杂(比如含多个子模块),建议提前用
.vsls.json控制可见范围,避免暴露敏感配置
共享范围决定对方能做什么
启动会话时弹出的选项不是摆设——它直接控制终端、调试器、本地服务是否被广播出去。选错会导致协作卡在“只能看不能动”的尴尬状态。
-
Only editors:仅同步代码编辑,对方看不到终端、无法打断点、连不上本地localhost:3000 -
Include terminal and debugger:推荐日常使用,终端输入、断点命中、变量监视全部同步 -
Full workspace:最开放,共享.vscode/settings.json权限,对方可能读到你配的密钥路径或代理设置,慎选 - 若用
vscode-live-server,必须选后两项,否则Go Live按钮不自动共享端口和 URL
链接发出去后,对方怎么加入?
生成的链接形如 https://vscs.live/abc123?sig=xyz&exp=1748765200,带签名和过期时间(默认 24 小时),不能手动拼、不能改参数,否则 403。
- 对方点击链接,若已安装 Live Share 并登录,会自动唤起 VS Code 并加入会话
- 若对方没装扩展,页面会跳转到扩展安装页;安装后需重启 VS Code 才能生效
- 微信/钉钉内点击链接,可能被拦截为“非安全域名”,此时应长按复制链接,粘贴到浏览器地址栏打开
- 链接一旦生成,主机侧关闭 VS Code 或退出登录,会话立即终止,所有访客收到“Session ended by host”提示
真正容易被忽略的是权限粒度:你以为共享了项目,但对方打不开某个文件,可能是你工作区里存在 .vsls.json 显式排除了它;你以为对方能调试,结果断点灰掉,其实是启动时只勾了 Only editors。协作不是“开了就行”,而是每一层共享都得对得上预期。











