VSCode中Docker插件在远程开发环境（SSH/WSL2/Dev Container）默认不激活，需切换至本地窗口安装；插件依赖系统PATH中的docker命令，应通过终端启动VSCode以继承环境变量；日志需启用Follow logs，镜像/容器列表卡顿时可调大刷新间隔或隐藏非必要视图。
VSCode里搜不到Docker插件？检查远程开发环境
VSCode的Docker插件（Docker，由Microsoft官方维护）默认只在本地窗口可用；如果你连着SSH、WSL2或Dev Container，插件不会自动激活，搜索栏也压根不显示它。
- 先确认右下角状态栏是否显示
Remote - SSH、WSL或Dev Container—— 如果有，点开它，选择Open in Local Window - 再按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS），搜Docker，安装Docker插件（注意作者是Microsoft） - 装完重启VSCode，且确保 Docker Desktop（或
dockerd服务）正在运行，否则插件会提示“Cannot connect to the Docker daemon”
Docker插件没显示镜像/容器？验证docker CLI可访问性
插件依赖系统 PATH 中的 docker 命令，不是靠配置文件路径硬编码。哪怕你用 Homebrew、Snap 或手动解压安装了 Docker CLI，只要终端里能跑 docker ps，插件就该识别；但 VSCode 启动方式会影响环境变量继承。
- 别从桌面图标或 Dock 启动 VSCode —— 它可能拿不到 shell 的 PATH。改用终端启动：
code（macOS/Linux）或code .（Windows WSL） - 在 VSCode 终端（
Ctrl+`）里执行which docker和docker version --client，确认输出正常 - 如果用 M1/M2 Mac 装了 Rosetta 版 Docker Desktop，但 VSCode 是原生 ARM64 构建，可能因架构不匹配导致通信失败——统一用 ARM64 版本更稳
点开容器日志全是空？注意日志驱动和实时刷新机制
插件里点击容器 → Logs 标签页，默认只拉取最近 100 行、非实时流式输出。很多用户以为“没日志”，其实是被截断或没触发刷新。
- 右键日志面板 → 选
Follow logs才开启实时追加（等效于docker logs -f） - 如果容器用的是
none或syslog日志驱动，docker logs本身就不返回内容 —— 插件自然为空，需改用json-file驱动（启动时加--log-driver=json-file） - 某些 Alpine 基础镜像默认关闭
stdout缓冲，应用日志不立即刷出；可在启动命令前加stdbuf -oL -eL强制行缓存
镜像列表卡顿或加载慢？关掉自动刷新和非必要标签
插件默认每 5 秒轮询 docker images 和 docker ps -a，当本地有上百个镜像或几十个历史容器时，UI 明显卡顿，甚至导致资源监视器里 code helper 进程吃满 CPU。
- 在 VSCode 设置里搜
docker.refreshInterval，改成30000（30秒）或干脆设为0关闭自动刷新 - 右键侧边栏 Docker 图标 →
Hide 'Images'或Hide 'Containers'，只留当前需要的视图 - 避免同时展开多个容器的
Inspect或Exec子项——每个展开都会触发一次docker inspect请求，叠加后延迟明显
真正麻烦的不是装不上，而是插件在后台静默失败：比如 Docker daemon 没响应时它不报错，只让列表空着；或者日志驱动不兼容时，它连提示都不给。盯住 VSCode 底部状态栏的 Docker 图标颜色（灰色=离线，蓝色=就绪），比反复点开面板更省时间。
