Docker插件在VSCode中无法显示本地容器与镜像，需依次检查Docker Desktop运行状态、重载VSCode工作区并启用插件权限、排除.devcontainer配置冲突、手动设置DOCKER_HOST环境变量、重置插件缓存。
如果您在 Visual Studio Code 中安装了 Docker 插件，但无法通过图形界面查看或操作本地容器与镜像，则可能是由于插件未正确连接到 Docker 守护进程或工作区配置异常。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、确认 Docker Desktop 正在运行并启用 WSL2 集成（Windows）或 Unix 套接字（macOS/Linux）
VSCode 的 Docker 插件依赖于本地 Docker 守护进程提供的 API 接口，若守护进程未启动或未暴露标准通信路径，插件将显示为空白或报“Cannot connect to the Docker daemon”错误。
1、打开 Docker Desktop 应用程序，等待右上角鲸鱼图标变为稳定状态（非旋转中）。
2、点击鲸鱼图标 → “Settings” → “General”，确认已勾选 Start Docker Desktop when you log in 和 Use the new Virtualization framework（macOS）。
3、在 macOS 上，终端执行 docker info，验证输出中包含 Server Version 字段且无 connection refused 错误。
二、重新加载 VSCode 工作区并启用 Docker 扩展权限
VSCode 插件在首次加载工作区时可能因权限限制无法自动获取 Docker 环境变量，需手动触发上下文重载以刷新扩展能力边界。
1、关闭当前所有 VSCode 窗口，包括后台进程（可通过 Activity Monitor 强制退出 Code Helper 进程）。
2、在终端中执行 code --disable-extensions 启动无扩展模式。
3、再次执行 code --enable-extension ms-azuretools.vscode-docker 仅启用 Docker 插件并打开任意文件夹。
三、检查远程开发容器（Dev Container）配置冲突
若当前工作区存在 .devcontainer/devcontainer.json 文件，Docker 插件会优先尝试连接远程容器上下文，从而隐藏本地镜像/容器列表，导致可视化面板失效。
1、在 VSCode 资源管理器中查找并临时重命名 .devcontainer 文件夹为 .devcontainer.bak。
2、按下 Cmd+Shift+P（macOS）调出命令面板，输入并选择 Docker: Refresh Containers。
3、观察侧边栏 Docker 视图是否恢复显示本地 Images 和 Containers 节点。
四、手动指定 DOCKER_HOST 环境变量路径
当 Docker 守护进程监听非默认套接字路径（如通过 colima 或 Rancher Desktop 启动）时，VSCode 插件无法自动识别，需显式声明通信端点。
1、终端执行 echo $DOCKER_HOST，记录输出值（例如 unix:///Users/xxx/.colima/docker.sock）。
2、在 VSCode 设置中搜索 docker host，找到 Docker: Host 配置项。
3、将该设置值修改为上一步获取的完整路径，并确保路径中不包含空格或中文字符。
五、重置 Docker 插件状态缓存
Docker 插件会在 ~/.vscode/extensions/ms-azuretools.vscode-docker-*/out/ 目录下缓存容器元数据快照，损坏的缓存可能导致 UI 渲染中断或节点不可展开。
1、关闭 VSCode，进入终端执行 rm -rf ~/.vscode/extensions/ms-azuretools.vscode-docker-*。
2、重新打开 VSCode，前往 Extensions Marketplace 搜索 Docker 并点击 Install。
3、安装完成后，不重启编辑器，直接按 Cmd+Shift+P 输入 Developer: Toggle Developer Tools，切换到 Console 标签页，观察是否有 docker.listImages 或 docker.listContainers 的成功响应日志。
