Live Share 不提供真正的服务器共享,仅同步状态;协作核心是终端、文件上下文与权限控制。需主机手动安装 vscode-live-server 并启动服务,来宾通过浏览器访问其地址,而非共用同一本地服务。

Live Share 本身不提供“服务器共享”能力,所谓“共享 Live Server”只是状态同步的错觉;协作的核心是共享终端、文件上下文和权限控制,不是转发端口。
Live Share 启动前必须装对扩展
只装 Live Share 不够,协作中若需实时运行网页或调试前端,还得手动装 vscode-live-server。但注意:这个插件只在主机本地起作用,来宾看到的是静态文件列表和终端输出,不是真正“共用一个 http://localhost:5500”。常见错误是来宾双击 HTML 文件试图预览,结果打开的是本地 file:// 协议——因为 vscode-live-server 的服务没被代理过去。
- 主机需安装
vscode-live-server并点击状态栏Go Live启动服务 - 来宾无需装该插件,但需知道服务地址(如
http://localhost:5500/index.html)并手动粘贴到自己浏览器 - 若想让来宾也能一键启动服务,得统一用
npm start或python3 -m http.server等跨平台命令,写进package.json或Makefile
终端共享不是“远程登录”,而是会话镜像
开启 "liveshare.terminalSharing": true 后,所有人在同一终端窗口里输入命令,光标位置、历史记录、当前工作目录完全同步。这不是 SSH,没有独立 shell 进程;任意一方执行 cd ..,所有人立刻跳转。容易踩的坑:
- 主机用
zsh,来宾用bash:命令补全、别名、提示符样式不一致,但执行逻辑不受影响 - 执行耗时命令(如
npm install)时,有人误按Ctrl+C,整个会话中断,所有人退出进程 - 终端输出含 ANSI 颜色码时,部分旧版 VS Code 渲染异常,建议主机用
NO_COLOR=1临时禁用颜色
权限配置决定协作是否可控
默认设置下,来宾拥有编辑权限,能删文件、改代码、运行任意命令。生产环境或带敏感配置的项目必须提前限制。关键配置项都在 settings.json 里:
-
"liveshare.accessControl.read": ["guest"]—— 允许来宾读取所有文件 -
"liveshare.accessControl.write": ["owner"]—— 写权限仅限主机,来宾无法保存修改 -
"liveshare.terminalSharing": "write"—— 终端可交互,设为"read"则只能看不能输命令 - 不配
accessControl就等于裸奔,尤其当项目含.env或secrets.yml时
协作中断后终端不会自动重连
主机关闭 VS Code 或网络断开,来宾终端立即变成“未激活”状态,显示 Terminal is not active in the current session。此时已运行的进程(如 nodemon、webpack serve)并不会自动终止,但输出不再同步。最稳妥的做法是:
- 主机恢复连接后,手动在终端里敲
clear+ 回车,触发一次新 prompt 同步 - 不要依赖“自动重连”,VS Code 不会重建已断开的长期进程
- 若用
docker-compose up启了容器,断连不影响容器运行,但日志流会卡住,需重新docker logs -f
真正的难点不在启动按钮,而在谁有权限执行哪条命令、终端行为是否可预期、断连后状态怎么恢复——这些细节没配好,协作效率反而比发 PR 还低。











