如何在Dockerfile中根据M1 Mac/AMD架构条件构建镜像？

方案一：构建参数（最灵活通用） #

这是最推荐的方式，通过Docker的构建参数动态控制FROM指令的平台参数，不用改动Dockerfile结构就能适配不同场景。

Dockerfile写法 #

# 定义构建参数，默认值为空
ARG TARGET_PLATFORM=

# 用Shell参数展开语法：只有当TARGET_PLATFORM有值时，才添加--platform选项
FROM ${TARGET_PLATFORM:+--platform=$TARGET_PLATFORM} ubuntu:22.04

# 后续镜像构建步骤...

构建命令 #

• 本地开发镜像：直接构建，自动适配M1 Mac的ARM架构

docker build -t my-dev-app .

• 生产镜像：传入参数指定AMD64平台

docker build --build-arg TARGET_PLATFORM=linux/amd64 -t my-prod-app .

方案二：多阶段构建+目标（适合开发/生产镜像差异大的场景） #

如果开发镜像需要额外调试工具、依赖，而生产镜像只保留最简内容，可以用多阶段构建分别定义不同平台的镜像。

Dockerfile写法 #

# 开发阶段：不指定平台，用M1原生ARM架构
FROM ubuntu:22.04 AS dev
# 安装开发用工具，比如vim、调试器等
RUN apt-get update && apt-get install -y vim curl htop

# 生产阶段：强制指定AMD64平台
FROM --platform=linux/amd64 ubuntu:22.04 AS prod
# 只安装生产必需的依赖
RUN apt-get update && apt-get install -y nginx

构建命令 #

• 构建开发镜像：指定目标为dev阶段

docker build --target dev -t my-dev-app .

• 构建生产镜像：默认构建最后一个阶段（prod），也可显式指定

docker build --target prod -t my-prod-app .

方案三：Docker Compose区分环境（适合用Compose管理服务的场景） #

如果平时用Docker Compose启动服务，可以通过多文件机制区分开发和生产的构建参数。

基础配置文件（docker-compose.yml，生产用） #

services:
  app:
    build:
      context: .
      args:
        TARGET_PLATFORM: linux/amd64
    # 其他生产配置...

开发覆盖文件（docker-compose.override.yml，自动合并） #

services:
  app:
    build:
      args:
        TARGET_PLATFORM: ""
    # 其他开发配置，比如挂载本地代码目录、开放调试端口...

启动命令 #

• 开发环境：直接启动，自动加载override文件

docker-compose up --build

• 生产环境：只加载基础配置文件

docker-compose -f docker-compose.yml up --build

最佳实践 #

• 本地开发尽量用原生ARM镜像，性能比模拟AMD64好很多，避免不必要的平台强制
• 构建参数方案通用性最强，不需要拆分Dockerfile，适合大部分场景
• 如果生产必须用AMD64，尽量通过外部参数控制，不要把平台信息硬编码在Dockerfile里，保持镜像的可移植性

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