构建失败时需用docker build --progress=plain .强制输出完整日志，可清晰定位出错的RUN指令、包安装失败或网络超时等具体原因，避免GUI默认折叠日志导致排查困难。
构建失败时只看到 failed to solve 或几行截断输出，根本没法定位是哪一行 RUN 出错、哪个包安装失败、还是网络超时——Docker Desktop 默认把构建日志压缩得过于激进，必须手动调整才能看到完整上下文。
构建时加 --progress=plain 强制输出完整日志
Docker Desktop 的 GUI 构建界面默认用的是 auto 进度模式，会折叠中间步骤、隐藏命令回显、甚至吞掉错误堆栈。真正有用的构建日志只能靠 CLI 驱动，并显式指定进度格式：
-
docker build --progress=plain .：每一步命令原样打印，RUN apt update的完整输出、报错行、退出码全在终端里 -
docker build --progress=plain -f Dockerfile.dev .：指定非默认Dockerfile时同样适用 - 别用
--progress=auto（GUI 默认）或--progress=quiet，后者连基础状态都不显示 - 如果构建过程卡住，
--progress=plain能让你一眼看出停在哪条指令、是否在等待输入或超时重试
docker buildx build 日志更全，但需启用 BuildKit
新版 Docker 默认开启 BuildKit，但部分旧版 Docker Desktop 或手动关闭后，docker build 仍走传统引擎，日志更简略。此时应优先用 buildx：
- 确认 BuildKit 已启用：
docker info | grep -i buildkit输出应含BuildKit: true - 使用
docker buildx build --progress=plain .，它比原生build多输出缓存命中详情、层哈希、远程 registry 推送日志 - 若提示
buildx is not a docker command，说明 buildx 插件未安装，运行docker buildx install - 注意：GUI 界面点 “Build” 按钮始终绕过
buildx，必须用终端执行
构建失败后，用 docker buildx du 查看残留构建缓存和中间镜像
构建中断或失败后，Docker 可能留下半成品中间镜像，它们不显示在 docker images 中，但会占用空间、干扰后续构建判断：
-
docker buildx du -v：列出所有构建缓存项，包括已失败步骤的临时层，每行带 ID 和大小 -
docker buildx prune：清理所有未被引用的构建缓存（不含正在使用的） -
docker system prune -a：慎用，会删掉所有镜像+构建缓存+未运行容器，适合彻底重来 - 关键点：构建日志里报错的那一步，其上一步成功生成的中间镜像 ID 会出现在
buildx du输出中，可docker run -it进去查环境、看文件、复现问题sh
最常被忽略的是：Docker Desktop 的 GUI 构建按钮根本不提供日志导出或滚动到底部的可靠方式，一旦窗口关闭，日志就丢了。真要排查，必须用终端跑 --progress=plain，并重定向到文件：docker build --progress=plain . > build.log 2>&1——否则下次构建失败，你又得从头手敲一遍。
