镜像管理如何清理由于构建失败产生的中间镜像

构建失败残留的<none>:<none>镜像是未被引用的构建层，非垃圾文件；应先docker builder prune清理缓存，再docker image prune删悬空镜像，必要时清理已停止容器。

构建失败后残留的中间镜像（常显示为 <none>:<none>）不是“垃圾文件”，而是未被最终镜像引用的构建层，直接硬删容易失败。清理的核心是分清缓存层和真正悬空镜像，按依赖关系逐步释放。

先清构建缓存，解决 80% 的删不掉问题

多数残留实际来自 BuildKit 缓存，而非镜像本身。这些缓存层可能仍被其他构建任务隐式引用，导致 docker rmi 报“被使用”。

1. 执行 docker builder prune：清理所有未被当前有效镜像引用的构建缓存层，安全且不影响已有镜像
2. 若想彻底重来（比如 CI 环境复位），用 docker builder prune -a：清空全部构建缓存，下次 build 会从头开始

再筛并删真正的悬空镜像

缓存清理后，原本被缓存“占着”的中间层会变成真正无人引用的状态，这时才能被安全删除。

1. 确认哪些是可删的悬空镜像：docker images -f dangling=true —— 只显示未被任何镜像或容器引用的 <none>:<none> 层
2. 一键清理：docker image prune（交互确认）或 docker image prune -f（跳过确认）
3. 注意：docker image prune -a 会删掉所有未被容器使用的镜像（包括你手动打过 tag 但没运行的），不是只删 <none>，慎用

删不掉时，查并清理引用它的已停止容器

如果某 <none> 镜像仍提示 “image is being used by stopped container”，说明有已退出但未删除的容器在依赖它。

1. 找出相关容器：docker ps -a --filter "ancestor=IMAGE_ID" -q
2. 批量删除：docker rm $(docker ps -a --filter "ancestor=IMAGE_ID" -q)
3. 再试 docker image prune 或针对该 ID 执行 docker rmi IMAGE_ID

日常建议：别等积压，定期小清

单次构建中断后，通常只需 docker builder prune + docker image prune 就够了。磁盘空间紧张时，再考虑 docker system prune -a（含容器、网络、卷等，会提示确认）。不复杂但容易忽略。