run指令日志反映dockerfile中每条run命令的实际执行过程与结果，包括原始指令、stdout/stderr输出、退出码（如non-zero code: x表示失败）及镜像层哈希，需重点关注退出码、关键命令执行痕迹和警告信息以快速定位问题。
构建日志里看到的 RUN 指令输出，反映的是 Dockerfile 中每条 RUN 命令在构建镜像时的实际执行过程和结果。关键不是“看哪一行”，而是理解它代表什么、是否成功、以及为什么失败。
RUN 指令在日志中的典型表现
当你运行 docker build，每遇到一条 RUN apt update && apt install -y curl 这类指令，Docker 会启动一个临时容器，执行该命令，并将结果（包括文件系统变更）提交为新镜像层。日志中你会看到：
- 以
>>>或RUN开头的一行，显示原始指令内容（如RUN apt-get update） - 紧随其后是该命令的标准输出（stdout/stderr），比如包列表、下载进度、安装确认等
- 最后以
---> [hash]或Successfully built [hash]结尾，表示该层构建完成 - 若失败，则会显示错误信息（如
Command 'apt-get' not found或returned a non-zero code: 100），并终止构建
重点关注 RUN 日志里的三类信息
不用逐行读完所有输出，盯住这几个信号点即可快速判断：
-
退出码是否为 0：最后一行若出现
non-zero code: X（X ≠ 0），说明该 RUN 命令执行失败，构建中断 -
关键命令是否真被执行：比如
RUN pip install flask后没看到Successfully installed flask-，可能因网络问题跳过或被缓存误判 -
警告是否掩盖错误：有些命令（如
apt-get install）即使部分包未装上也返回 0，日志里却有Unable to locate package xxx—— 这类警告需手动检查，不能只看“success”字样
如何快速定位问题所在的 RUN 行
构建失败时，Docker 默认只报最后一行错误，但实际问题常出在前面。建议这样排查：
- 从日志底部往上翻，找到第一个带
non-zero code的 RUN 行，它就是失败点 - 如果构建成功但运行异常，回看对应 RUN 行的输出：有没有
Warning:、Not Found、Skipping等关键词 - 用
docker build --progress=plain .获取更详细、无折叠的日志，避免默认的“简化视图”隐藏关键信息 - 对可疑 RUN 指令，单独提取出来在临时容器中验证：
docker run --rm -it ubuntu:22.04 sh -c "apt update && apt install -y xxx"
RUN 和 CMD/ENTRYPOINT 的日志区别要分清
新手容易混淆：RUN 是构建阶段执行，日志出现在 docker build 过程中；而 CMD 或 ENTRYPOINT 是容器启动时才运行，它的输出出现在 docker logs 里，不会出现在构建日志中。如果你在构建日志里找不到某条命令的输出，很可能它根本不在 RUN 里，而是写在了 CMD 中。
