VSCode 1.99+ 连不上 Ubuntu 20.04 容器主因是容器内实际 glibc 版本低于 2.28（如精简镜像 fallback 至 2.27），导致 vscode-server 启动失败；需验证真实版本、改用 ubuntu:22.04 等兼容镜像，或降级 VSCode 至 1.96。
VSCode 1.99+ 连不上 Ubuntu 20.04 容器是 glibc 版本不兼容
VSCode 从 1.99 版本（2025 年 3 月发布）起，预构建的 vscode-server 只支持 glibc ≥ 2.28 的 Linux 发行版。Ubuntu 20.04 自带 glibc 2.31，看似达标，但部分精简镜像或自定义构建的容器实际运行时会 fallback 到更低版本（如 2.28 以下），导致服务器启动失败，报错类似 vscode-server failed to start: missing symbol __libc_start_main@GLIBC_2.28。
这不是 Docker 插件失效，也不是网络或权限问题——docker ps 和 docker exec -it 都能正常工作，唯独 VSCode 的远程容器连接卡在“Installing VS Code Server”阶段。
- 用
docker exec -it <container> ldd --version查看容器内真实 glibc 版本 - 进容器执行
getconf GNU_LIBC_VERSION，输出必须为glibc 2.28或更高 - 若低于该值，别折腾
apt upgrade libc6——强行升级极易破坏系统，且 Ubuntu 20.04 官方源不提供更高版本
devcontainer.json 必须显式指定兼容镜像或构建参数
即使你本地有新版 Ubuntu 镜像，devcontainer.json 若只写 "image": "ubuntu" 或 "image": "ubuntu:20.04"，仍可能拉到旧缓存或非官方镜像，glibc 不达标。必须明确指向已验证兼容的镜像。
- 推荐改用
"image": "ubuntu:22.04"或"image": "debian:bookworm-slim"（glibc 2.36） - 若必须用 Ubuntu 20.04 环境，改用官方
ubuntu:20.04镜像（非第三方精简版），并在devcontainer.json中加"features"显式安装依赖，避免 base 镜像被替换 - 使用
"build"时，确保Dockerfile第一行是FROM ubuntu:22.04或更高，且未通过apt install -t focal-backports等方式降级 libc
回退 VSCode 版本是最快速的临时解法
如果你无法立刻重构容器环境，关闭自动更新并降级 VSCode 是最省事的选择。注意：不是所有旧版都兼容，需退回至 1.96 或更早（1.97/1.98 在部分系统上仍有兼容性波动）。
- 关闭自动更新：
Settings → update.mode → none - 下载地址固定为：
https://code.visualstudio.com/updates/v1_96（2024 年末稳定版） - Windows/macOS 直接覆盖安装；Linux 用户需手动替换
/usr/share/code下的二进制文件，并确认code命令指向新路径 - 降级后，
Remote - Containers扩展无需重装，但建议清除~/.vscode-server缓存目录，避免残留旧版 server 文件干扰
Linux/WSL2 下 socket 权限与上下文冲突常被误判为版本问题
当 VSCode 报错 Failed to connect. Is Docker running? 或 EACCES /var/run/docker.sock，很多人直接跳去查 glibc，其实只是权限没生效。尤其 WSL2 + Docker Desktop 组合下，newgrp docker 不一定立即刷新 VSCode 的进程组继承。
- 运行
groups，确认输出含docker；若无，执行sudo usermod -aG docker $USER后，**必须完全退出所有终端和 VSCode 实例，再重新打开** - 检查
docker context ls，确保当前上下文是default，而非desktop-linux或其他；WSL2 用户有时会被 Docker Desktop 自动切换上下文 - 不要用
sudo chmod 666 /var/run/docker.sock——这是安全隐患，正确做法是sudo chown root:docker /var/run/docker.sock && sudo chmod 660 /var/run/docker.sock
真正棘手的是混合场景：容器 glibc 达标，权限也对，但 VSCode 仍卡在安装 server。这时要盯住容器内 /root/.vscode-server（或 /home/vscode/.vscode-server）目录是否存在、是否可写，以及 vscode-server 的日志输出——它藏在容器的 /tmp/vscode-remote-containers-server-log.txt 里，比 VSCode UI 提示更早暴露符号缺失或权限拒绝细节。
