VSCode连不上远程容器主因是Docker守护进程未通、用户权限不足或devcontainer.json配置缺失关键字段；需依次验证docker info是否成功、当前用户是否在docker组、.devcontainer/devcontainer.json路径及image/build等必填字段是否正确。
VSCode 连不上远程容器，90% 的情况不是插件坏了，而是 Docker 守护进程没通、权限没给够、或者 devcontainer.json 配置里漏了关键字段。别急着重装插件，先按顺序查这三块。
docker info 命令报错：Cannot connect to the Docker daemon
这是最底层的通信断开，VSCode 根本发不出任何构建或 attach 请求。
- 在终端运行
docker info，若提示Cannot connect to the Docker daemon，说明 VSCode 扩展连 Docker CLI 都调不动 - macOS / Windows：确认 Docker Desktop 已启动且状态栏图标为绿色；未启动就点开它，等 10–20 秒再试
- Linux（systemd）：执行
sudo systemctl status docker，若 inactive，运行sudo systemctl start docker并启用开机自启：sudo systemctl enable docker - WSL2 用户注意：Docker Desktop for Windows 默认已集成 WSL2 后端，但需在 Docker Desktop 设置中勾选 “Use the WSL2 based engine”，否则
docker命令可能指向空壳
devcontainer.json 缺失或字段不合法
VSCode 只认 .devcontainer/devcontainer.json 这个路径和文件名，大小写、隐藏属性、JSON 语法全错不得。
- 检查项目根目录下是否存在
.devcontainer/devcontainer.json（不是devcontainer.json直接放在根目录，也不是DevContainer.json） - 必须包含
"image"或"build"字段之一；如果用"build"，要确保"dockerfile"路径存在且可读（比如"dockerfile": "./.devcontainer/Dockerfile"） - VSCode 底部状态栏显示
JSON: Invalid？立刻右键 → “Format Document”，或粘贴到 jsonlint.com 校验——常见坑是末尾多逗号、单引号代替双引号、中文标点 - Windows 用户特别注意：
${localWorkspaceFolder}在挂载时若路径含空格或中文，会导致Build failed: context not found；建议把项目移到C:\dev\myproject这类纯英文无空格路径
用户没加入 docker 组或 socket 权限异常
即使 docker ps 能运行，VSCode 插件也可能因权限隔离失败——尤其 Linux 和 WSL2 下。
- 运行
groups，确认输出里有docker；没有就执行sudo usermod -aG docker $USER，然后newgrp docker（不用重启系统） - 检查 socket 文件权限：
ls -l /var/run/docker.sock，正确应为srw-rw---- 1 root docker；若属组不是docker或权限不是660，手动修复：sudo chown root:docker /var/run/docker.sock && sudo chmod 660 /var/run/docker.sock - VSCode 必须继承当前 shell 的用户组环境；如果从桌面图标启动，它可能没加载
docker组。改用终端启动：code .，或显式传参：/usr/bin/code --no-sandbox . - WSL2 + Ubuntu 场景下，
sudo service docker start启动后，还需确保DOCKER_HOST环境变量未被错误覆盖（比如设成tcp://localhost:2375）；默认应为空，让 CLI 自动走unix:///var/run/docker.sock
真正卡住的地方往往藏在「看似能跑」的环节里：比如 docker ps 成功但 VSCode 仍报连接失败，大概率是用户组没刷进当前会话，或 devcontainer.json 里写了 "remoteUser": "root" 却没配 "mounts" 导致工作区不可见——这些细节不报错，只静默失败。
