Docker Desktop 怎样查看构建缓存占用

Docker Desktop 里看构建缓存，建议分成两层：先在 Builds 视图定位某次构建的缓存使用趋势，再用当前 builder 执行 docker buildx du 查看缓存条目、大小和可回收空间。前者适合判断哪次构建突然变慢，后者适合回答“到底占了多少磁盘”。

官方地址：https://www.docker.com/products/docker-desktop/

一、先从 Docker Desktop 的 Builds 视图定位构建

1. 入口：打开 Docker Desktop，在左侧导航选择 Builds，进入 Build history。如果正在构建，切到 Active builds；右上角先确认当前选中的 builder。
2. 选择记录：点击目标构建，优先按时间、项目名或构建来源定位，不要把已经移除或停止的 builder 当成当前缓存。
3. 成功标志：详情页出现该构建的 Info、Logs、Source 等标签，说明记录属于当前可用的 builder。

Docker 官方说明，Builds 视图只列出活动运行中的 builder；Windows 容器的 legacy builder 不会出现在这里。因此列表为空时，先检查 builder 是否停止，以及构建是否确实使用 BuildKit。

二、在构建详情里看缓存命中与历史变化

在已完成的构建详情中打开 Info，找到 Build timing 区域，再看 Cache usage。这个视图回答的是“这次构建有多少操作复用了缓存”，不等同于本机缓存目录的总磁盘大小。

如果要看连续多次构建的变化，进入 History。时间序列会把相关构建的耗时、步骤数和缓存使用放在一起；缓存命中明显下降，通常意味着 Dockerfile 的前置层、COPY 输入或构建参数发生了变化。这里先记录异常构建，再去命令行查占用，排查会更准确。

三、用 docker buildx du 读取当前 builder 的精确明细

打开与 Docker Desktop 相同环境的命令行，执行下面的命令。它只读取当前选中的 builder；如果你使用多个 builder，必须显式指定目标名称。

# 查看当前选中 builder 的构建缓存明细与汇总
docker buildx du

# 需要展开每条记录的来源和最近使用时间时，使用 pretty 输出
docker buildx du --verbose

# 多 builder 环境中，指定要检查的 builder
docker buildx du --builder mybuilder

重点看四个汇总字段：Shared 是与其他资源共享的部分，Private 是 builder 私有部分，Reclaimable 是可尝试回收的部分，Total 是当前统计到的总量。条目旁的星号表示可变记录或共享记录，不能简单地把每行大小相加。

四、根据可回收空间选择清理方式

只想释放构建缓存时，优先使用 docker buildx prune，它的范围比 docker system prune 更窄。先不加 --force 看清待删除内容；确认无误后再执行。

# 只清理当前 builder 的可回收构建缓存，先保留确认步骤
docker buildx prune

# 仅在确认提示和缓存范围后，跳过交互确认
docker buildx prune --force

# system prune 会同时影响其他未使用对象，谨慎使用
docker system prune

如果只是磁盘紧张，不要直接把 system prune --volumes 当成查看缓存的后续动作，它还会涉及容器、网络、镜像以及匿名卷。清理后重新执行 docker buildx du，以同一个 builder 的 Total 和 Reclaimable 作为结果依据。

常见问题

为什么 Builds 页面没有我刚才的构建？

先核对当前 builder 是否仍在运行，再确认构建是否由 BuildKit 执行；页面只展示活动 builder 的记录，legacy builder 或已移除 builder 的记录不会出现。

Builds 里的 Cache usage 能代表缓存占用大小吗？

不能直接等同。它主要描述构建操作的缓存使用程度；要看磁盘条目、共享部分和可回收空间，应在相同 builder 上运行 docker buildx du。