Dockerfile跨平台（arm64/amd64）RUN语句的最佳实现方案

官方推荐方案：单Dockerfile + 条件指令 + 多平台构建 #

Docker官方更倾向于用单Dockerfile结合条件RUN指令，配合docker buildx实现跨架构适配，避免维护多份Dockerfile的冗余和同步成本。

具体实现步骤 #

1. 通过ARG传递架构标识
   在Dockerfile开头定义架构参数，构建时Docker会自动填充TARGETARCH变量（对应目标架构，如amd64、arm64）：

ARG TARGETARCH
# 直接使用已适配的基础镜像变量
FROM ${BASE_IMAGE}

2. 条件执行PowerShell安装逻辑
   根据TARGETARCH区分不同架构环境，执行对应安装命令。以Debian/Ubuntu系镜像为例：

RUN if [ "$TARGETARCH" = "amd64" ]; then \
        apt-get update && apt-get install -y powershell; \
    elif [ "$TARGETARCH" = "arm64" ]; then \
        # 若arm64环境有特殊安装源或包名，替换此处命令
        apt-get update && apt-get install -y powershell; \
    fi

3. 用docker buildx完成跨架构构建
   启用buildx多平台构建器，一次构建并推送适配多架构的镜像：

docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t your-image:tag --push .

不推荐维护双Dockerfile的原因 #

• 冗余度高：两份文件大部分内容重复，修改一处需同步更新另一处，极易出错
• 维护成本高：长期迭代中会出现版本不一致的风险
• 不符合Docker最佳实践：官方更推崇单文件适配多平台的模式，减少维护负担

额外优化建议 #

• 将架构相关的依赖安装逻辑封装成Shell脚本，COPY进镜像后条件执行，让Dockerfile更简洁
• 本地测试不同架构构建结果时，可指定--platform参数：

  # 在WSL2中测试arm64架构构建
  docker build --platform linux/arm64 -t your-image:arm64-test .
  

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