docker history 可查看镜像每层的来源、大小和生成时间，显示 dockerfile 指令、增量大小及创建时间；推荐用 --no-trunc、--format 和 --filter 等参数提升可读性与排查效率。
用 docker history 就能直接看到镜像每一层是怎么来的、有多大、什么时候生成的。它不显示文件内容，而是展示构建过程中每一步操作留下的元数据，比如哪条 Dockerfile 指令触发了这一层、这一层新增了多少数据。
基础查看：快速列出分层信息
运行命令即可获取默认格式的历史记录：
-
docker history nginx:alpine—— 查看指定镜像的完整构建路径 - 输出列包括：IMAGE（层 ID）、CREATED（时间）、CREATED BY（对应指令）、SIZE（该层增量大小，非累计）、COMMENT（通常为空）
- 最上面一行是当前镜像 ID，往下是它的父层，逐层追溯到基础镜像
让输出更实用：推荐加的参数
默认输出常截断长指令或 ID，影响判断。建议组合使用：
-
--no-trunc：显示完整指令和完整层 ID，避免省略关键内容 -
--format "{{.CreatedBy}} => {{.Size}}"：只聚焦“谁干的”和“干了多少”，适合快速扫描 -
--human=false：把 SIZE 输出为字节数，方便脚本计算或排序 -
--filter "size>0"：跳过空层（如 ENV、LABEL 等不改文件系统的指令），减少干扰
定位体积问题：找“胖层”
镜像太大，往往因为某一层悄悄塞进了大量文件。可以这样排查：
- 按大小倒序排列（Linux/macOS）：
docker history --no-trunc nginx:alpine | sort -k5 -hr | head -10 - 重点关注含
apt-get install、npm install、COPY .或缺少清理步骤（如没删/var/lib/apt/lists/*）的层 - 注意：单个 RUN 合并多条命令会生成一层；拆成多个 RUN 就变多层——层数 ≠ Dockerfile 行数
配合 inspect 进一步深挖
如果想确认某层在磁盘上的实际存储位置或校验信息，可补查：
-
docker inspect nginx:alpine | jq '.[0].RootFS.Layers'—— 输出各层 SHA256 digest 列表（需提前装 jq） - 这个结果和
docker history的顺序一致，可用于比对或自动化分析
