必须先通过Remote-SSH成功连接并加载远程项目,Live Share才能共享真实代码和终端;否则协作者仅看到本地空工作区。因Live Share依赖Remote-SSH建立的远程会话状态,无法绕过直接访问远程环境。

Remote-SSH 和 Live Share 必须配合使用,且顺序不能颠倒:先连通 Remote-SSH,Live Share 才能共享真实远程项目;否则协作者看到的是本地空工作区。
Remote-SSH 连接失败时 Live Share 为什么只显示空白文件夹
Live Share 不会绕过本地 VSCode 的连接状态直接访问远程服务器。它只同步当前已加载的工作区——如果 Remote-SSH 还没成功打开远程目录,VSCode 资源管理器里显示的仍是本地路径,Live Share 就只能共享这个空壳。
- 左下角没有绿色 SSH 标识(如
SSH: user@host),说明未真正接入远程环境 - 资源管理器中列出的是你本地的
C:\project或/Users/name/project,而非/home/user/project - 此时点击 Live Share 图标启动会话,协作者加入后看到的是你本地机器上那个空文件夹
- 解决办法:必须先通过
Remote-SSH: Connect to Host连上,并在弹出窗口中选择远程路径(如/home/user/myapp)
Live Share 在远程会话中哪些功能实际不可用
Remote-SSH 建立的是“单人远程开发环境”,Live Share 在此基础上做实时同步,但它不继承管理员权限、不转发 sudo、也不允许协作者越界操作。
- 协作者无法执行
Remote-SSH: Open Folder in Remote—— 只能编辑主机已打开的远程文件 - 共享终端中输入
sudo会卡住或报错,因为密码输入不被转发 - 新建远程文件夹、上传文件、手动安装插件等操作,协作者均无权限
- 若需运行部署脚本,建议提前写好
deploy.sh,再通过共享终端一起查看输出
远程插件必须装在 remote 端才能被 Live Share 同步
VS Code 的插件分本地(local)和远程(remote)两套加载逻辑。Live Share 只同步 remote 端已启用的功能,本地装的插件对协作者不可见。
-
ESLint、Prettier、Python等需读取远程配置或解释器的插件,必须在远程服务器上安装:右下角弹窗点Install on SSH: xxx,而不是在本地扩展面板点 Install -
GitLens本地安装无效;只有远程安装后,协作者才能看到 blame 提示和 commit 历史 - 调试配置中的
"program": "${workspaceFolder}/main.py"必须指向远程路径,否则断点不生效 - 检查方式:打开远程终端,运行
code --list-extensions --show-versions,确认关键扩展出现在输出中
最容易被忽略的是连接稳定性——Remote-SSH 的 SSH 会话一旦中断(比如网络抖动、服务器休眠),Live Share 会话会立即断开,且不会自动重连。建议在远程服务器上确认 ClientAliveInterval 已设为 60 或更低,并避免使用不稳定的 WiFi 直连云服务器。


















