docker builder prune --help 可查看构建缓存清理全部参数；--all 删除所有未用缓存，--force 跳过确认，--filter 支持 label、until、id 等条件筛选；清理前建议用 docker system df 和 docker buildx du -v 查看缓存现状；仅作用于 buildkit 缓存。
直接运行 docker builder prune --help 就能看到构建缓存清理的全部操作参数。
常用参数说明
--all / -a：删除所有未使用的构建缓存（包括近期仍在用但当前无活跃构建引用的缓存），默认只清理“可安全回收”的旧缓存。
--force / -f：跳过确认提示，直接执行清理，适合脚本中使用。
--filter：按条件筛选缓存再清理，支持多种过滤器：
-
label=xxx=true：保留带指定标签的缓存（配合docker build --build-arg BUILDKIT_INLINE_CACHE=1 --label important=true .可实现标记保护） -
until=240h：只清理超过 10 天（240 小时）未访问的缓存 -
id=xxx：按缓存 ID 精确匹配（ID 可从docker buildx du输出中获取）
辅助查看命令
清理前建议先查清缓存现状：
-
docker system df：看 Build Cache 行的 SIZE 和 RECLAIMABLE 值 -
docker buildx du -v：列出每条缓存的 ID、大小、最后访问时间，带详细路径信息
注意点
该命令仅影响 BuildKit 启用后的构建缓存（Docker 18.09+ 默认启用）。若仍用传统构建器，docker builder prune 不生效，需改用 docker system prune 或禁用缓存重建。
