VSCode Docker扩展失败的根本原因是网络未连通官方市场或本地Docker CLI不可达。需检查扩展市场访问、docker version输出、工作区禁用设置、用户组权限、远程上下文匹配，并确认容器支持vscode-server。
VSCode 安装 Docker 扩展失败：找不到插件或安装后不显示侧边栏
根本原因通常是 VSCode 没连上官方扩展市场，或者用了国内镜像源但配置失效。不是插件本身坏了，而是网络或代理卡住了。
实操建议：
- 先在 VSCode 里按
Ctrl+Shift+X（macOS 是Cmd+Shift+X）打开扩展面板，直接搜Docker—— 看是否列出官方出品的Docker（发布者是Microsoft），图标是鲸鱼 logo - 如果搜不到，点扩展面板右上角三个点 →
Install from VSIX...，去官网手动下载：https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker（注意选对应平台的.vsix文件） - 如果已安装但左侧没出现
Docker图标，重启 VSCode；若仍无，检查是否启用了工作区禁用扩展（.vscode/extensions.json里有"disabled": true）
Docker 扩展识别不了本地 Docker daemon：显示 “Docker is not reachable”
扩展依赖本地 docker CLI 能正常通信，而不是只装了桌面版 Docker Desktop 就完事。常见于 WSL2、Linux 或 macOS M1/M2 用户。
实操建议：
- 终端里运行
docker version，必须返回 client + server 信息；如果报错Cannot connect to the Docker daemon，说明 daemon 没启动或权限不对 - Windows + WSL2：确保 Docker Desktop 设置里勾选了
Use the WSL 2 based engine，且在 WSL 中执行docker context use default - Linux：普通用户需加入
docker用户组：sudo usermod -aG docker $USER，然后完全退出终端重登 - macOS：M1/M2 用户避免混用 Intel 和 ARM 版本的 CLI，统一用
brew install --cask docker安装官方包
点击容器日志/终端没反应，或右键菜单缺失“Attach Visual Studio Code”
这个功能依赖容器内预装 vscode-server，不是所有镜像都支持。尤其 Alpine、scratch 类极简镜像默认不带 shell 或基础工具链。
实操建议：
- 确认容器运行时带
-it参数（交互式终端），否则扩展无法 attach；后台模式（-d）下只能看日志，不能进终端 - 想用
Attach Visual Studio Code，镜像得有/bin/sh或/bin/bash，且磁盘未只读挂载（ro会阻止 vscode-server 自动部署） - Alpine 镜像可临时加装：
apk add --no-cache bash；FROM scratch 的镜像基本不支持，别硬试 - 日志打不开？检查容器是否设置了
--log-driver=none，或日志路径被覆盖（如通过docker run --log-opt max-size=10m限制过小）
远程开发（SSH/WSL）下 Docker 扩展无法管理本地镜像
VSCode 远程连接时，默认调用的是远程机器上的 docker CLI，不是你本机的。你以为在管 Mac 上的镜像，其实它在扫 Ubuntu 服务器的空 docker 环境。
实操建议：
- 不要在远程窗口里依赖 Docker 扩展管理本机资源；要么切回本地窗口操作，要么把远程机器的 Docker daemon 暴露出来（不推荐，有安全风险）
- 如果非要在远程窗口用本机 Docker，可在远程机器的
~/.bashrc中设置：export DOCKER_HOST=tcp://your-mac-ip:2375，并在 Mac 的 Docker Desktop 设置里开启Expose daemon on tcp://localhost:2375（⚠️仅限可信局域网） - 更稳妥的做法：本地写好
Dockerfile和docker-compose.yml，用扩展构建/推送，再 ssh 到远程执行docker pull & run
真正卡住人的地方，从来不是“怎么点开 Docker 面板”，而是 CLI 是否就绪、上下文是否匹配、远程和本地环境是否被混淆。多看一眼 docker version 和 VSCode 状态栏右下角的 Docker 图标状态，比反复重装扩展有用得多。
