docker history 命令用于查看镜像构建层级、指令、大小及创建时间，支持 --no-trunc、--format 等选项优化输出，可定位“胖层”并结合 docker inspect 分析存储结构。
使用 docker history 命令可以快速查看镜像的构建层级（layers）、每层对应的指令、大小、创建时间等关键信息，是分析镜像体积、优化 Dockerfile 和排查构建问题的常用手段。
基础用法：查看镜像分层结构
执行以下命令即可列出指定镜像的完整构建历史：
docker history <镜像名或ID>
例如：
docker history nginx:alpine
输出中各列含义如下：
- IMAGE：该层对应的镜像 ID（最顶层为当前镜像 ID）
- CREATED：该层创建时间
-
CREATED BY：生成该层所执行的 Dockerfile 指令（如
/bin/sh -c #(nop) COPY ...） - SIZE：该层增量大小（注意不是累计大小）
- COMMENT：通常为空，部分镜像可能有备注
常用选项提升可读性与实用性
默认输出可能被截断，建议配合以下参数使用：
-
--no-trunc：显示完整的镜像 ID 和指令内容，避免省略（强烈推荐） -
--format：自定义输出格式，例如只看指令和大小：docker history --no-trunc --format "{{.CreatedBy}} => {{.Size}}" nginx:alpine -
--human=false：以字节数显示 SIZE（便于脚本处理）
识别“胖层”并定位体积瓶颈
镜像体积过大常因某一层意外引入大量文件（如未清理的缓存、重复复制、调试工具）。通过 docker history 可快速定位异常大的层：
- 按 SIZE 降序排序（Linux/macOS）：
docker history --no-trunc nginx:alpine | sort -k5 -hr | head -10 - 重点关注含
apt-get install、npm install、COPY .或未清理缓存（如rm -rf /var/lib/apt/lists/*缺失）的层 - 若某层 SIZE 明显偏高（如 >50MB），应检查对应 Dockerfile 行是否可优化（多阶段构建、.dockerignore、清理临时文件等）
结合 docker inspect 理解层与文件系统关系
docker history 展示的是构建视角的逻辑层，而实际存储依赖 docker inspect 中的 RootFS.Layers。可交叉验证：
docker inspect --format '{{json .RootFS.Layers}}' <镜像名>
返回的是 SHA256 摘要列表，与 docker history 中的 IMAGE 列（短 ID）一一对应，可用于排查层复用、镜像签名或存储驱动细节。
