VSCode Docker插件看不到本地容器主因是PATH未继承，需从终端启动或手动配置docker.path；右键构建镜像名总为<none>因未传-t参数，须在弹窗中填写镜像名；调试需端口映射+运行时调试模式+launch.json配置；删镜像失败因悬空层依赖，应先Prune Dangling Images。
安装 Docker 插件后为什么看不到本地容器？
VSCode 的 Docker 插件（Microsoft 官方维护）依赖本地 docker CLI 可执行文件和 Docker daemon 正常运行。常见现象是插件面板显示“no containers”或“connection refused”，但终端里 docker ps 能正常工作——这通常是因为 VSCode 没继承 shell 的 PATH，找不到 docker 命令。
解决方法：
- macOS / Linux：确保 VSCode 从终端启动（例如在 zsh 中执行
code），避免从 Dock 或 Spotlight 启动 - Windows：检查是否启用了 WSL2 后端；若使用 Docker Desktop，确认其系统托盘图标为绿色且已启动
- 所有平台：在 VSCode 设置中搜索
docker.path，手动设为/usr/local/bin/docker（macOS/Linux）或C:\Program Files\Docker\Docker\resources\bin\docker.exe（Windows）
右键“Build Image”生成的镜像名为什么总是 <none>？
VSCode Docker 插件默认调用 docker build 时不传 -t 参数，导致镜像未打标签。虽然构建成功，但后续无法用 docker run -it <image-id> 直观引用，也难以区分多个构建结果。
正确做法：
- 在项目根目录下创建
.dockerignore，排除 node_modules、.git 等非必要文件，避免上下文过大影响构建速度 - 右键
Dockerfile→ “Build Image…” → 在弹出的输入框中**必须填写镜像名和可选标签**，格式如myapp:dev或registry.example.com/myapp:latest - 如果常用固定命名，可在
settings.json中配置："docker.imageName": "myapp:${env:USER}"（支持环境变量）
如何从 VSCode 直接调试正在运行的容器进程？
插件本身不提供进程级调试能力，但它能快速打开容器终端、查看日志、复制 ID，为调试铺路。真正调试需结合语言运行时（如 Node.js 的 --inspect、Python 的 debugpy）和端口映射。
实操要点：
- 启动容器时务必加
-p映射调试端口（如 Node.js 的9229）：右键镜像 → “Run Interactive…” → 在参数框填-p 9229:9229 --name myapp-dev - 容器内启动服务时启用调试模式：例如
node --inspect=0.0.0.0:9229 app.js（注意绑定0.0.0.0而非127.0.0.1） - 在 VSCode 中配置
launch.json的type: "pwa-node"，port设为9229，address设为localhost（宿主机视角） - 插件右键容器 → “Attach Shell” 可进入 bash 查看进程、日志路径等，比反复
docker exec更快
删除镜像时提示 “conflict: unable to remove repository reference” 怎么办？
这是 Docker 的保护机制：当存在未加标签（<none>）的中间层镜像，且有其他镜像依赖它时，直接删带标签的镜像会失败。VSCode 插件右键删除只作用于标签，不清理悬空层。
安全清理步骤：
- 先在插件中右键目标镜像 → “Prune Dangling Images”，清除所有
<none>镜像（不影响运行中容器） - 再右键需要删除的镜像 → “Remove Image”
- 若仍失败，说明该镜像被某容器引用：右键对应容器 → “Inspect”，查
Image字段确认 ID，再用终端执行docker rm -f <container-id>停止并删除容器 - 日常建议开启自动清理：在 Docker Desktop 设置中勾选 “Clean up unused containers and images on exit”
插件省事，但底层仍是 Docker CLI。对镜像生命周期的理解越清楚，越不容易误删或卡在“无法删除”的状态里。
