清理 docker 镜像需“删得准、删得稳、删得有依据”，分四环节：一、先看清——用 docker system df -v、docker images -a 等命令识别占用空间、悬空镜像及引用关系；二、精准删——按场景选用 docker image prune -f、按标签筛选删除或 docker-compose down --rmi all；三、防堆积——在 ci/cd 和定时任务中自动清理老旧镜像；四、避坑——明确标签非镜像实体、勿手动删 /var/lib/docker 文件、生产环境慎用 docker system prune -a。
清理 docker 镜像不是“删得越多越好”，而是“删得准、删得稳、删得有依据”。真正卡住多数人的，不是命令记不住，而是不知道该删谁、为什么能删、删了会不会影响运行服务。下面从实际操作出发，分四个关键环节讲清楚。
一、先看清：哪些镜像在占空间、谁还在用它们
盲目删除前，必须掌握当前镜像的真实状态。执行以下命令获取结构化信息：
-
总览磁盘占用：运行
docker system df -v，重点关注 Images 下的 “Total Size” 和 “Reclaimable” 列，它会告诉你哪些镜像是可回收的； -
列出所有镜像（含悬空）：用
docker images -a，特别注意<none></none>标签的行——它们是 dangling 镜像，大概率可删； -
查某镜像是否被容器引用：运行
docker ps -a --filter ancestor=nginx:1.25 --format "{{.ID}} {{.Status}}"，若返回结果，说明有容器基于它创建过（即使已停止），需谨慎； -
看镜像层构成与时间：用
docker image inspect --format '{{.RepoTags}} {{.Created}} {{.Size}}' nginx:1.25，确认创建时间和大小，辅助判断是否为近期构建或测试产物。
二、精准删：按场景选择安全删除方式
不同情况对应不同策略，避免一刀切：
-
只删无标签且未被引用的中间层：执行
docker image prune -f，这是最安全的起步操作，专清 dangling 镜像； -
删某个仓库下的所有旧版本（保留 latest）：例如清理
myapp的非 latest 标签：docker images myapp --format "{{.Tag}} {{.ID}}" | grep -v "latest" | awk '{print $2}' | xargs -r docker rmi； -
配合 docker-compose 彻底清理整套服务资源：在项目目录下运行
docker-compose down --rmi all，它会停容器、删网络、并删除 compose 文件中声明的所有镜像（包括远程拉取的有标签镜像）； -
强制删某个镜像（忽略引用警告）：仅限开发环境快速重试时用，如
docker rmi -f ubuntu:22.04，但务必确认没有正在运行或即将启动的容器依赖它。
三、防堆积：让清理变成自动习惯
靠人手动清理迟早失效，建议嵌入日常流程：
- 在 CI/CD 脚本末尾加入
docker image prune -f，每次构建后自动清悬空层； - 用定时任务定期清理老旧镜像，例如每周删掉 14 天前创建的非 latest 镜像：
docker images --format "{{.CreatedAt}} {{.Repository}}:{{.Tag}}" | while read ts repo_tag; do [[ $(date -d "$ts" +%s 2>/dev/null) -lt $(date -d "14 days ago" +%s) ]] && [[ "$repo_tag" != *":latest" ]] && docker rmi "$repo_tag" 2>/dev/null; done； - 在
docker-compose.yml中为服务显式指定镜像 digest（如image: nginx@sha256:abc123...），避免因latest标签覆盖导致历史镜像失去标签却无法识别。
四、避坑要点：这些细节决定删得稳不稳
很多故障源于对底层机制理解偏差：
-
标签 ≠ 镜像：
docker rmi myapp:v1.2只是断开标签指向，若同一镜像 ID 还有myapp:stable引用，数据不会释放； -
镜像 ID 才是唯一实体：多个标签可共用一个 ID，用
docker images --digests查看 digest，比对是否真为同一份内容； -
不要直接删
/var/lib/docker下文件：Docker 存储有元数据索引，手动删会导致状态错乱，只能通过 CLI 命令触发安全回收； -
生产环境慎用
docker system prune -a：它会删掉所有未被容器引用的镜像、卷、网络、构建缓存，可能误伤备份卷或离线调试镜像。
