docker images 无法准确列出 docker compose 项目所用镜像，因其可能源自本地已有镜像、远程拉取或 build 指令构建；需结合 docker-compose config 解析服务镜像声明（image 或 build.context），再通过 docker images 核查实际存在的镜像，辅以 docker images -f dangling=true 排查多阶段构建产生的悬空镜像。
直接用 docker images 看不到 Docker Compose 项目用了哪些镜像，因为 Compose 启动的容器可能基于本地已有镜像、远程拉取的镜像，甚至通过 build 指令从 Dockerfile 构建——这些镜像未必都出现在 docker images 的默认列表里。要准确盘点一个 Compose 项目实际依赖的所有镜像，得结合 docker-compose config 和镜像状态检查。
查看 Compose 文件中声明的所有镜像来源
运行以下命令，解析并展开所有服务的镜像配置（包括变量替换、继承和构建上下文）：
docker-compose config --services | xargs -I {} docker-compose config | yq e ".services.{}.image // .services.{}.build?.context" -更稳妥的做法是分步执行：
- 先列出所有服务名：
docker-compose config --services - 对每个服务，提取
image字段或build.context路径：docker-compose config | yq e '.services.<service_name>.image' -</service_name>（若为空，再查.build?.dockerfile或.build?.context）
例如，某服务定义为 build: ./api，说明它将从 ./api/Dockerfile 构建镜像，最终生成的镜像名由 image: 指定，或默认为 <project_name>_<service_name></service_name></project_name>。
识别已构建/已拉取的镜像 ID 和标签
启动过一次项目后，可用以下命令汇总当前环境中与该项目相关的所有镜像：
docker-compose config --services | xargs -I {} sh -c 'docker-compose config | yq e ".services.{}.image // (\"<project>_{}\")" -' | sort -u | while read img; do docker images "$img" --format "{{.Repository}}:{{.Tag}} {{.ID}}" 2>/dev/null; done | sort -u</project>说明：
- 自动补全未显式指定
image:的服务名（如myapp_web） - 过滤掉不存在的镜像（
2>/dev/null），只显示已存在本地的 - 输出格式为
repository:tag image_id，方便核对
检查是否遗漏了多阶段构建或临时构建镜像
如果 Compose 使用了 build: 且 Dockerfile 含多阶段（如 FROM golang:alpine AS builder），中间构建阶段的镜像不会被 Compose 自动打标签，但会留在 docker images 中，状态为 <none>:<none></none></none>。
排查方法：
- 运行
docker images -f dangling=true查看悬空镜像 - 结合
docker history <image_id></image_id>确认是否来自你的项目构建上下文 - 清理时可加
--no-cache或用docker builder prune（Docker 23.0+）释放空间
一键生成镜像清单报告（推荐脚本化）
保存为 list-images.sh，在 compose 项目根目录运行：
#!/bin/sh
PROJECT=$(basename "$(pwd)")
echo "=== 镜像清单（项目：$PROJECT） ==="
docker-compose config --services | while read svc; do
img=$(docker-compose config | yq e ".services.$svc.image // \"${PROJECT}_$svc\"" - 2>/dev/null)
if [ "$img" != "null" ]; then
echo "- $svc → $img"
docker images "$img" --format " → {{.Repository}}:{{.Tag}} ({{.ID}})" 2>/dev/null || echo " → 未找到本地镜像"
fi
done执行前确保已安装 yq（v4+），它是解析 YAML 的关键工具。
