Docker忽略Dockerfile中--platform标志，如何生成linux/amd64镜像？

问题根源 #

Docker默认会以当前构建机器的架构（M1的linux/arm64）作为最终镜像的平台，哪怕你在runtime阶段指定了--platform=linux/amd64，只要没明确覆盖全局设置，最终输出还是会沿用默认架构。Podman则会严格遵循Dockerfile里的平台声明，这就是两者行为不同的原因。

具体解决办法 #

1. 构建命令直接指定目标平台 #

最简单的方式是在build命令里明确标注最终要生成的平台，覆盖Docker的默认逻辑：

docker build --platform=linux/amd64 .

这样既保留了构建阶段用M1原生arm64加速编译的优势，最终产出的镜像也会是linux/amd64架构。

2. Dockerfile里全局声明平台参数 #

如果不想每次构建都加命令参数，可以在Dockerfile开头添加全局参数，让构建阶段和运行阶段的平台逻辑更清晰：

# 全局指定最终运行的目标平台
ARG TARGETPLATFORM=linux/amd64
# 构建阶段自动用当前机器的原生架构（M1的arm64）加速编译
FROM --platform=$BUILDPLATFORM rust:latest AS builder
WORKDIR /app
COPY . .
# 注意：需要提前安装Rust交叉编译工具链：rustup target add x86_64-unknown-linux-gnu
RUN cargo build --target x86_64-unknown-linux-gnu --release

# 运行阶段严格使用指定的amd64平台
FROM --platform=$TARGETPLATFORM scratch AS runtime
COPY --from=builder /app/target/x86_64-unknown-linux-gnu/release/your-app /
CMD ["/your-app"]

这里$BUILDPLATFORM是Docker内置变量，会自动识别当前构建机器的架构，保证编译速度；$TARGETPLATFORM则固定了最终镜像的运行平台。

3. 修改Docker默认平台配置 #

如果平时经常需要构建amd64镜像，可以直接改Docker的全局默认设置：

• 打开Docker Desktop，进入Features in development选项页
• 找到Default platform，选择linux/amd64后重启Docker
  之后所有默认构建都会以amd64为目标平台，不用再额外加参数。

内容的提问来源于stack exchange，提问作者Michael X