Docker插件不显示容器或镜像，主因是无法连接本地Docker环境：需检查docker CLI路径、用户权限（加入docker组并重登）、构建上下文设置、远程主机配置及架构兼容性。
Docker 插件装完不显示容器或镜像，不是插件没装好，而是它根本连不上本地 Docker 环境。 VSCode 的 Docker 插件（Microsoft 官方版）只是个图形壳，所有操作都靠调用 docker 命令和连接 dockerd 守护进程。你终端里能跑 docker ps，不代表插件也能——它启动时可能压根没拿到你的 PATH、权限或上下文。
插件找不到 docker CLI：检查启动方式和 PATH
VSCode 从桌面图标或 Dock 启动时，常丢失 shell 的环境变量，导致插件查不到 docker 可执行文件。
- 在终端里运行
which docker，记下路径（比如/usr/bin/docker或/opt/homebrew/bin/docker） - VSCode 设置里搜
Docker: Path，填入上面的完整路径，保存后执行Developer: Reload Window - 更稳的做法：始终用终端启动 VSCode —— macOS/Linux 执行
code .，Windows WSL 同理；这样能继承当前 shell 的PATH和DOCKER_HOST - 如果用 M1/M2 Mac，确认 Docker Desktop 和 VSCode 都是 ARM64 架构，混用 Rosetta 版本会导致通信静默失败
Linux 用户看不到容器：权限组没生效或没重登
docker ps 要加 sudo 才能跑？说明当前用户不在 docker 组里，而 VSCode 不会自动提权。
- 执行
sudo usermod -aG docker $USER - ⚠️ 关键：必须完全退出当前桌面会话（关机/登出再登录），仅重启 VSCode 或
systemctl --user restart docker都无效 - 验证：新开终端执行
groups，确认输出含docker；再跑docker info不报 permission denied
构建 Dockerfile 失败：上下文路径错得离谱
右键 Dockerfile → Build Image 报 COPY failed: forbidden path outside the build context？不是语法错，是插件默认把当前打开的文件夹当构建上下文（.），而 COPY 只能访问这个目录及子目录。
- 最省事：把
Dockerfile放到项目根目录，所有被COPY的文件（如package.json、src/）都在它同级或下方 - 临时救急：右键
Dockerfile→Build Image，弹窗里把Context改成.（项目根路径），别留空或填错相对路径 - 进阶控制：用命令面板
Ctrl+Shift+P→Docker: Build Image，手动指定Dockerfile路径（如./src/Dockerfile）和Context（如.），等价于docker build -f ./src/Dockerfile .
容器列表为空或只显示部分：默认只列运行中容器
插件侧边栏 “Containers” 节点默认只展示 docker ps 结果，已停止的容器藏在 “Stopped” 分组里，不展开就看不见。
- 点侧边栏 Docker 视图顶部的三个点 →
Refresh，确保状态同步（尤其刚用 CLI 启停过容器） - 右键任意容器 →
View Logs却空白？大概率该容器启动后立刻退出（比如主进程是sleep 1）；用docker run -d nginx这种带-d的才会长期运行并出现在列表里 - 远程 Docker 主机需手动配置：
DOCKER_HOST环境变量不会被插件自动读取，必须在 VSCode 设置里填Docker: Host（如tcp://192.168.1.100:2375）
最容易被忽略的是：插件对上下文（context）和用户组权限极度敏感，而这两项的修复动作（重登系统、填绝对路径、改构建上下文）没有中间态——要么全对，要么完全不工作。别猜，直接按路径和权限两条线逐项验证。
