VS Code团队协作远程开发的核心是统一远程执行环境，所有成员必须通过Remote-SSH连接同一台Linux服务器（如Ubuntu Server LTS），禁用密码登录、共用部署用户、严格管理SSH密钥，并确保插件、调试器、终端全部在远程侧运行和配置。
VS Code 团队协作远程开发，核心不是装一堆插件，而是先统一远程执行环境——所有成员必须连接到同一台服务器或容器，否则 Live Share 之类的功能只是“共享编辑器状态”，不是“共享运行时上下文”。
Remote-SSH 是团队协作的基础设施，不是可选项
团队里有人用 WSL、有人直连物理机、还有人开 Docker 容器？协作会立刻失效。必须强制所有成员通过 Remote-SSH 连接到同一个 Linux 服务器（推荐 Ubuntu Server LTS），这是唯一能保证 tasks.json、launch.json、gdb 调试路径、环境变量、Python 解释器位置全部一致的方式。
- 服务器上必须提前装好
openssh-server，且sshd_config中启用PasswordAuthentication no和PubkeyAuthentication yes - 团队共用一个部署用户（如
devteam），不要每人建一个账号——避免~/.vscode-server目录分散、扩展安装不一致 - 本地
~/.ssh/config中统一配置 Host 别名，例如：Host team-dev、HostName 192.168.50.10、User devteam、IdentityFile ~/.ssh/team_id_rsa - 私钥
team_id_rsa必须由管理员分发，权限严格设为600；严禁用密码登录，否则无法触发自动vscode-server安装
Live Share 不能替代 Remote-SSH，只能叠加使用
很多人误以为装了 ms-vsliveshare.vsliveshare 就能协作，结果发现断点不同步、终端打不开、gdb 报 No such file or directory。根本原因是 Live Share 默认在“本地 VS Code 进程”里跑调试器，而你真正需要的是“在远程服务器上跑调试器，再把状态推给所有人”。
- 必须先通过
Remote-SSH连入服务器，再启动 Live Share —— 此时 Host 的launch.json才会实际生效，Guest 也能看到真实进程 ID 和内存变量 - Guest 加入后，
Debug Adapter仍运行在 Host 的远程机器上，所有调试指令经由 SSH 隧道转发，不是本地模拟 - 禁用 Live Share 的
Share Terminal选项：它默认共享的是本地终端，和远程环境无关；应改用 Remote-SSH 自带的Ctrl+`终端
插件安装位置必须锁定在远程，否则 IntelliSense 失效
团队协作中最常被忽略的一点：VS Code 插件有“本地安装”和“远程安装”两种模式，C/C++、Python、clangd 等语言服务类插件一旦装错位置，就只会分析 Windows/macOS 路径，完全无法识别远程头文件或 sysroot。
- 打开 Remote-SSH 连接后，在扩展面板顶部点击
… → Install Local Extension on SSH: team-dev，手动把插件推送到服务器 - 检查插件是否真在远程生效：打开一个
.c文件，右下角状态栏应显示C/C++: IntelliSense Engine: Default，且Ctrl+Click能跳转到/usr/include/stdio.h等系统头文件（而不是报“no definition found”） - 禁止在本地安装
ms-python.python后让它“自动同步”——它会尝试用本地 Python 解析远程代码，路径全错；必须在远程侧单独安装并指定python.defaultInterpreterPath为/home/devteam/.pyenv/shims/python类路径
调试器端口与防火墙是协作卡顿的隐形杀手
多人同时调试时出现“断点灰色不可用”“变量值显示 loading…”“调试器突然中断”，90% 是因为 gdbserver 或 ptvsd 绑定的端口被占或被拦截，而非代码问题。
- 在
launch.json中显式指定port字段（如"port": 50001），避免多个成员默认都用5000冲突 - 服务器防火墙需放行该端口：
sudo ufw allow 50001；若用 Docker 容器，还需加-p 50001:50001映射 - 禁用
launch.json中的justMyCode（Python）或stopAtEntry（C/C++）等非必要选项，它们会在每次调试启动时额外拉起进程，加剧端口竞争
真正的协作难点从来不在连接成功那一刻，而在于所有成员是否真的在操作同一套文件系统、同一个 shell 环境、同一个调试器实例——任何一层脱钩，都会让“实时协作”退化成“轮流编辑”。所以别急着分享链接，先确认 whoami、pwd、which python 在每个人窗口里输出完全一致。
