docker history 命令可直接查看镜像构建历史及每层增量大小，展示的是分层元数据（如指令、时间、SIZE），而非文件内容；用于优化体积、定位“胖层”、验证 RUN/COPY 是否生效；需配合 --no-trunc 避免截断，--format 定制输出，并注意层数与 Dockerfile 行数常因基础镜像、RUN 合并等而不一致。
用 docker history 命令就能直接查看镜像的构建历史和每一层的大小。
这个命令展示的是镜像的分层结构，不是文件内容，而是每层对应的 Dockerfile 指令、创建时间、增量大小等元数据。它对优化镜像体积、定位“胖层”、验证 COPY/RUN 是否生效特别有用。
查看基础构建历史
运行以下命令：
docker history <镜像名或ID>
例如：
docker history nginx:alpine
输出中关键列含义：
- IMAGE：该层的 ID（最上面一行是当前镜像 ID）
- CREATED：该层生成时间
-
CREATED BY：触发该层的指令（如
RUN apt-get install -y curl） - SIZE：这一层的增量大小（不是累计大小）
- COMMENT：通常为空
让输出更清晰实用
默认输出会截断长指令或 ID，建议加参数：
-
--no-trunc：显示完整指令和完整镜像 ID，避免...省略 -
--format：自定义字段，比如只看指令和大小：docker history --no-trunc --format "{{.CreatedBy}} => {{.Size}}" nginx:alpine -
--human=false：把 SIZE 改为字节数（适合脚本解析）
为什么层数和 Dockerfile 行数不一致？
-
FROM拉取的基础镜像自带多层，全算进 history，但不在你的 Dockerfile 里 - 多个命令写在同一个
RUN里（如RUN a && b && c）会被合并成一层 - 反之，拆成多个
RUN就生成多个层
配合 inspect 进一步分析
如果想看层的存储路径、压缩信息或 diff ID，可补查：
docker inspect <镜像名> | jq '.[0].RootFS.Layers'
（需安装 jq，输出的是各层 SHA256 digest 列表）
不复杂但容易忽略细节。
