docker history 可查看镜像构建历史，展示每层的指令、时间、增量大小等元数据；输出按底层到顶层排列，关键列含 IMAGE、CREATED、CREATED BY、SIZE；推荐用 --no-trunc、--format 和 --filter 提升可读性；层数≠Dockerfile行数因基础镜像自带层且多命令RUN合并为一层。
用 docker history 就能直接查看镜像的构建历史，它展示的是每一层的元数据——比如哪条指令生成了这层、创建时间、增量大小，而不是文件内容本身。
基础用法：快速看全貌
运行命令即可列出镜像所有层：
-
docker history nginx:alpine—— 查看官方 alpine 版 nginx 的完整构建过程 - 输出从底层（基础镜像）到顶层（最新层）排列，最上面一行是当前镜像 ID
- 关键列包括：IMAGE（层 ID）、CREATED（时间）、CREATED BY（对应 Dockerfile 指令）、SIZE（该层新增体积，非累计）
让输出更实用：加参数不踩坑
默认输出常截断长命令或 ID，影响判断。推荐组合使用：
-
--no-trunc：显示完整指令，例如RUN apt-get update && apt-get install -y curl不会被缩成/bin/sh -c apt-get... -
--format "{{.CreatedBy}} => {{.Size}}"：只提取指令和大小，适合快速定位“胖层” -
--filter "size>0"：过滤掉0B的元数据层（如 ENV、LABEL），聚焦真实文件变更
为什么层数 ≠ Dockerfile 行数？
这是常见困惑点，原因很实际：
- 基础镜像（如
FROM ubuntu:22.04）自带多层，全算进 history，但不在你的 Dockerfile 里 - 一个
RUN里写多条命令（RUN a && b && c）只生成一层；拆成三个RUN就变三层 -
COPY和RUN通常各占一层，CMD/ENTRYPOINT多数为0B层
配合 inspect 进一步深挖
如果想确认某层的实际存储路径或校验值，可补查：
-
docker inspect nginx:alpine | jq '.[0].RootFS.Layers'—— 输出各层 SHA256 digest 列表（需装jq） - 结合
docker history --no-trunc的层 ID，能精准对应到具体构建动作 - 这对排查缓存失效、验证多阶段构建是否生效特别有用
