vscode docker插件镜像列表为空或不刷新，根本原因是未连上docker守护进程：终端启动code .继承path、linux用户需加入docker组并完全重登、插件默认只查default上下文且不自动同步。
VSCode 的 Docker 插件能直接列出、拉取、删除本地镜像，但前提是它能调用 docker CLI 并连上守护进程；否则所有操作都会卡在“空列表”或“unable to delete image”——这不是 UI 问题，而是底层权限或上下文没对上。
为什么镜像列表为空或不刷新
插件不主动轮询，也不自动继承终端环境。常见断连点有三个：
-
docker info在终端能成功，但 VSCode 是从桌面图标启动的 → 它没拿到 shell 的PATH，需在终端执行code .启动 VSCode - Linux 用户未加入
docker组 → 运行groups看输出是否含docker，不含就执行sudo usermod -aG docker $USER，然后**完全退出图形会话重登**（仅重启 VSCode 无效） - 上下文被切到远程或自定义 context → 插件默认只查
default，不会读DOCKER_CONTEXT环境变量；右下角状态栏会显示当前 context 名（如my-remote），点击可切换，或用命令面板输入Docker: Switch Context手动切回default
右键 Pull Image 时填什么地址
支持完整仓库地址，格式和 docker pull 一致，不需要额外加前缀或后缀：
- 公开镜像：
nginx:alpine、redis:7.2 - 私有 registry：
ghcr.io/username/app:latest、registry.example.com/myapp:v1.0 - 带 digest 的精确拉取：
alpine@sha256:abc123...
输错会立刻报错，比如 unauthorized（没登录）、not found（镜像名或 tag 不存在），插件不缓存错误提示，建议先在终端试 docker pull xxx 确认可用性。
删镜像失败：提示 “unable to delete image”
这是 Docker 引擎返回的拒绝操作，不是插件 bug。根本原因是镜像正被引用：
- 被某个容器（含已停止的）作为基础镜像运行 → 在插件里展开
Images节点，目标镜像右侧若标有used by container，就得先清理容器 - 被 dangling 子镜像依赖 → 先执行
docker image prune清悬空镜像，再删目标 - 想跳过检查强制删 → 右键选
Remove Image (Force)，等价于docker image rm -f，但可能破坏层共享，导致其他镜像体积异常增大
安全顺序：先 docker ps -a --filter ancestor=IMAGE_ID -q 查引用容器，删掉它们；再删镜像；最后补一次 docker image prune 收尾。
Build Image 失败：找不到 COPY 的文件
插件默认把 Dockerfile 所在目录设为构建上下文（build context），而 COPY 只能访问该目录及子目录下的路径：
- 如果
Dockerfile在./src/Dockerfile，但写了COPY package.json .→ 报错，因为package.json在项目根目录 - 最稳解法：把
Dockerfile移到项目根目录，所有COPY路径都相对于它 - 临时绕过：右键
Dockerfile→Build Image…→ 弹窗中手动把Context改成.（项目根目录） - 进阶控制：勾选
Advanced，用-f指定Dockerfile路径，用.指定上下文，等价于docker build -f ./src/Dockerfile .
注意：插件不校验 .dockerignore 是否生效，它由 daemon 解析，插件只是静默转发构建请求——所以忽略规则没起作用时，得回终端看 docker build 输出确认。
