Docker 27默认启用BuildKit导致83%的CI流水线静默构建不兼容镜像，根源在于其自动推断平台且不继承FROM镜像平台声明，需通过显式--platform或Dockerfile中FROM--platform=linux/amd64修复。
默认用的是 BuildKit，但不是所有项目都兼容；如果你遇到 docker build 报错说“unknown flag: --progress”或构建阶段莫名跳过，大概率是构建器不匹配导致的。
怎么确认当前用的是哪个构建器
执行 docker buildx inspect --bootstrap，看输出里 driver 字段：如果是 docker 表示传统 builder（即 docker daemon 内置构建器），docker-container 或 docker + buildkit:true 表示启用了 BuildKit。
更直接的方式是查环境变量：echo $DOCKER_BUILDKIT。值为 1 表示强制启用 BuildKit；为空或 0 则走传统路径（除非命令行显式加 --progress 等 BuildKit 专属参数，会自动 fallback 失败）。
如何临时切换构建器（单次构建）
不用改全局设置，靠命令行参数就能控制：
- 强制用传统构建器：在
docker build命令前加DOCKER_BUILDKIT=0，例如DOCKER_BUILDKIT=0 docker build . - 强制用 BuildKit：加
DOCKER_BUILDKIT=1，或直接用docker build --progress=plain .（BuildKit 专属参数会自动触发） - 想绕过 BuildKit 的 stage 缓存逻辑（比如调试 COPY 失败时），可加
--no-cache，它在两种构建器下都有效，但行为略有差异：传统模式清全部层，BuildKit 只清当前 stage 后续依赖
如何永久禁用 BuildKit（避免 CI/CD 或脚本意外失败）
BuildKit 虽快，但对老旧 Dockerfile（比如含 RUN echo $VAR > file 且未用 ARG 声明）或某些多阶段 COPY 有兼容问题。永久关掉最稳妥：
- Windows/macOS：打开 Docker Desktop → Settings → Docker Engine，把 JSON 配置里的
"features": {"buildkit": true}改成false，或删掉整行（默认就是 false） - 必须确保配置中没有
"buildkit": true，哪怕写成"features": {"buildkit": false}也比留空更明确 - 改完点 Apply & Restart——这步不能跳，否则配置不加载
- 验证是否生效：重启后运行
echo $DOCKER_BUILDKIT应输出空，且docker build --help不再显示--progress选项
为什么 BuildKit 有时反而更慢或报错
BuildKit 默认开启并发构建和更激进的缓存复用，但这也带来几个隐性坑：
- 多阶段构建中，如果前一 stage 的
COPY --from=...引用了一个未显式FROM ... AS name命名的中间镜像，BuildKit 会静默跳过该 COPY，而传统构建器会报错提醒 - 某些 shell 特性（如
$(cat file)在 RUN 中）在 BuildKit 下可能因上下文隔离被截断，需改用heredoc或挂载--mount=type=bind - 使用
docker buildx build时若未指定--builder，它会创建新 builder 实例，默认启用 BuildKit，且不读取DOCKER_BUILDKIT环境变量——这是最常被忽略的「看似关了实则没关」场景
真正要稳，别只盯图形界面开关；环境变量、命令行参数、buildx builder 实例三者得一起看，缺一不可。
