Docker构建失败会残留dangling层，需用docker image prune安全清理；推荐启用BuildKit、多阶段构建及优化Dockerfile减少残留；清理效果可通过docker system df验证。
Docker 构建失败时，确实会残留大量未被标记的中间层（dangling layers），它们不关联任何镜像，但占用磁盘空间。清理的关键是识别并删除这些 dangling 镜像层，而不是误删正在使用的镜像。
确认 dangling 镜像层的存在
Docker 将构建中断或失败后遗留、且没有标签（<none>）和父级引用的层归类为 dangling 镜像。运行以下命令可列出它们：
docker images -f "dangling=true"
输出中显示的 REPOSITORY 和 TAG 均为 <none> 的条目，就是待清理的目标。
安全清理 dangling 镜像层
执行清理前建议先确认列表，再执行删除：
- 仅清理 dangling 镜像层（最常用、最安全）：
docker image prune - 同时清理所有未被容器引用的构建缓存（包括 build cache 中的中间阶段）：
docker builder prune - 若想一步清空所有未使用对象（含 dangling 镜像、构建缓存、未使用网络/卷等），需加
--all和--force：docker system prune --all --force（慎用，会删掉所有未被容器引用的镜像）
预防后续产生过多中间层
频繁构建失败导致堆积，往往源于 Dockerfile 或构建上下文问题。可从这几方面减少残留：
- 启用 BuildKit（推荐）：在构建前设置
export DOCKER_BUILDKIT=1，它默认更高效地复用和清理中间阶段 - 合理使用多阶段构建：把编译环境与运行环境分离，最终 stage 只保留必要文件，减少中间层暴露
- 避免在 Dockerfile 中使用
RUN apt-get install -y ... && apt-get clean这类未清理缓存的写法；改用apt-get install -y --no-install-recommends ... && rm -rf /var/lib/apt/lists/*
查看实际磁盘占用并验证效果
清理前后可用以下命令对比空间变化：
docker system df
重点关注 BUILD CACHE 和 IMAGE SPACE 下的 RECLAIMABLE 列——清理后该值应显著下降。
如果某次构建失败后仍看到大量 dangling 层，说明可能有构建过程被 kill 或 Ctrl+C 中断，此时 docker builder prune 比单纯 image prune 更彻底。
