VSCode Docker插件显示“Cannot connect to the Docker daemon”根本原因是未获得socket连接权，主因有三：终端docker info成功但VSCode未继承PATH/环境变量（需终端执行code .启动）；Linux用户未加入docker组且未完全退出重登；Docker Desktop未真正启动或上下文非default。
VSCode 本身不运行 Docker，它只是调用本地 docker CLI 和守护进程；只要 docker info 在终端能成功返回，插件就能工作——否则所有操作都会卡在“连不上 daemon”。
为什么 Docker 插件显示 “Cannot connect to the Docker daemon”
这不是插件坏了，而是它根本没拿到 socket 连接权。常见原因有三个：
-
docker命令在终端可用，但 VSCode 启动时没继承 shell 的PATH或环境变量（尤其从 Dock/桌面图标启动时）；改用终端执行code .启动 VSCode - Linux 用户未加入
docker组：groups输出里没有docker，需运行sudo usermod -aG docker $USER并**完全退出图形会话重登**（仅重启 VSCode 不生效） - Mac/Windows 上 Docker Desktop 没真正启动：右上角鲸鱼图标未稳定亮起，或设置里没勾选
Start Docker Desktop when you log in
容器列表为空或看不到正在运行的容器
插件默认只查 default context，但你可能已用 docker context use 切到远程或自定义上下文，而插件不会自动同步。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 检查状态栏右下角：Docker 插件会显示当前上下文名（如
default、my-remote），点击可切换 - 手动执行命令面板（
Ctrl+Shift+P/Cmd+Shift+P）→ 输入Docker: Switch Context→ 选回default - 不要在终端切完 context 后直接开 VSCode——插件初始化时已锁定上下文，后续变更不触发重载
右键删镜像失败：提示 “unable to delete image”
这是 Docker 引擎拒绝操作，不是 UI bug。本质是镜像被容器（含已停止的）或 dangling 子镜像引用。
- 先在插件里展开
Images节点，看目标镜像右侧是否标有used by container - 终端查依赖：
docker ps -a --filter ancestor=IMAGE_ID -q（把IMAGE_ID替成实际 ID），删掉输出的容器再试 - 更安全的清理顺序：
docker image prune（清悬空镜像）→ 再右键删目标镜像 - 强制删（
Remove Image (Force)）等价于docker image rm -f，可能破坏层引用，慎用
日志打不开、内容为空或不刷新
插件默认只拉最近 100 行且不自动流式追加，很多“没日志”其实是配置或驱动问题。
- 右键日志面板 → 选
Follow logs才开启实时流（等效docker logs -f） - 如果容器启动时用了
--log-driver=none或syslog，docker logs本身无输出，插件自然为空；应改用json-file驱动 - Alpine 等精简镜像常禁用 stdout 缓冲，应用日志不刷出；可在
docker run命令前加stdbuf -oL -eL - 插件每 5 秒轮询一次，镜像/容器过多时会卡顿甚至假死；可右键 Docker 视图 →
Hide unused nodes或调大刷新间隔（设置中搜docker.refreshInterval）
最易被忽略的是上下文（context）和环境变量继承问题——它们不随终端切换自动同步，也不因插件重装恢复；每次换开发机或重装系统后，这两处几乎必调。
