VSCode Docker插件依赖系统docker CLI，需确保docker服务运行、用户加入docker组、终端启动code .以继承PATH；右键构建实际执行docker build命令，注意上下文路径、.dockerignore生效及--build-arg需手动传参。
VSCode 本身不运行 Docker，但装对插件、配好环境后，镜像和容器管理确实能省掉 70% 的终端切换——前提是别踩权限、路径、远程窗口这三类坑。
安装 Docker 插件前必须确认 docker CLI 可用
插件不是独立运行的 Docker 客户端，它完全依赖系统 PATH 中的 docker 命令。很多“插件没反应”问题其实出在 CLI 层：
- 在 VSCode 内置终端（
Ctrl+`）中执行docker version，必须同时输出 client 和 server 版本；若报Cannot connect to the Docker daemon，说明 dockerd 服务没起来，或当前用户没权限访问/var/run/docker.sock - Linux 用户务必确认自己已加入
docker用户组：sudo usermod -aG docker $USER，然后重新登录（不是仅重启 VSCode） - 别从桌面图标启动 VSCode：它通常拿不到 shell 的 PATH。改用终端执行
code .启动，确保继承了docker的路径 - M1/M2 Mac 用户注意架构匹配：如果 Docker Desktop 是 Rosetta（x86_64）版，而 VSCode 是 ARM64 构建，通信可能失败；统一用 ARM64 版本更稳
右键 Build Image 实际调用的是什么命令
在 Docker 面板里右键 Dockerfile → Build Image，看着是点一下的事，背后默认执行的是：
docker build -t <your-input-tag> .
但它不等同于无脑执行——几个关键细节决定构建是否成功：
- 构建上下文默认是
Dockerfile所在目录，不是工作区根目录；如果COPY引用了上层文件，得手动指定上下文路径（右键菜单里选Build Image…，填--context） - 插件不会自动读取
.dockerignore，但 CLI 会；所以本地构建成功、插件构建失败，大概率是忽略规则没生效或路径写错 - 不支持
--build-arg图形化输入，需要提前在Dockerfile里用ARG声明，并在构建时手动加参数（比如右键后弹窗里填--build-arg NODE_ENV=production） - 构建失败时，错误日志直接透出 CLI 输出，但插件不高亮行号；建议失败后切到终端重跑一遍相同命令，方便定位 COPY 或 RUN 行
容器日志为空或卡顿的常见原因
点击容器 → Logs 标签页，看到空白或加载转圈，不是插件坏了，而是日志驱动或刷新机制不匹配：
- 默认只拉取最近 100 行，且不自动 follow；勾选
Follow logs才能实时流式输出（右上角齿轮图标里设置） - 某些基础镜像（如 Alpine）默认关闭 stdout 缓冲，应用日志不立即刷出；可在
docker run或devcontainer.json的runArgs里加--log-driver=json-file，或启动命令前加stdbuf -oL -eL - 本地镜像/容器太多时，插件每 5 秒轮询
docker ps -a和docker images，CPU 占用飙升；在设置里搜docker.refreshInterval，设为30000（30 秒）或0（关闭自动刷新） - 日志面板卡住时，先右键容器 →
View logs in Terminal，用原生命令验证是否真没日志；如果 CLI 也空，问题就在容器内，不是插件
Dev Container 启动失败时优先查哪几处
Reopen in Container 按钮点下去没反应，或卡在 “Building image”，往往不是镜像问题，而是配置链断裂：
-
.devcontainer/devcontainer.json里image或dockerFile路径写错，路径是相对于工作区根目录的，不是相对于.devcontainer目录 - 漏写
features或扩展依赖导致初始化失败，但错误被静默吞掉；打开命令面板 →Developer: Toggle Developer Tools，看 Console 是否有Failed to resolve dev container报错 -
forwardPorts字段只控制 UI 上是否显示可点击链接，不影响端口映射本身；真正起作用的是runArgs里的-p或ports数组 - 修改
devcontainer.json后必须执行Dev Containers: Rebuild and Reopen in Container，仅Restart Container不会重新构建镜像或重载配置
真正麻烦的从来不是点哪个按钮，而是当右键菜单消失、日志打不开、容器起不来时，你得知道该去终端敲哪条命令、该查哪个配置字段、该确认哪个用户组——插件只是快捷入口，底下的 Docker 还是那个 Docker。
