docker buildx通过一次构建打包多架构二进制并推送manifest list，使镜像在拉取时自动适配宿主机架构；需启用多平台builder、使用多架构基础镜像、执行--platform指定目标架构并--push推送至支持oci v2的仓库。
直接用 Docker Buildx 构建多平台镜像，就能让一个镜像自动适配 AMD64、ARM64、ARMv7 等不同 CPU 指令集架构，无需手动编译多个版本。关键不是“自适应运行时”，而是构建时就打包好各架构的二进制，由 Docker 运行时按宿主机自动选择对应变体。
确认本地支持 Buildx 并启用多架构构建器
Buildx 是 Docker 19.03+ 内置的实验性构建工具，需显式启用：
- 检查是否已安装：运行
docker buildx version，输出类似github.com/docker/buildx v0.10.4即可用 - 创建并切换到多架构构建器：
docker buildx create --use --name mybuilder --platform linux/amd64,linux/arm64,linux/arm/v7 - 验证当前构建器平台：
docker buildx inspect --bootstrap，确认输出中包含全部目标平台
编写兼容多架构的 Dockerfile
基础镜像和构建逻辑必须本身支持跨架构，重点在两点：
- 使用带多架构 manifest 的官方基础镜像，例如
golang:1.20-alpine、ubuntu:22.04、node:20-slim—— 它们在 Docker Hub 上已有 amd64/arm64/arm/v7 多版本镜像 - 避免硬编码架构相关命令（如
apt install gcc-arm64-linux-gnu），除非你明确在多阶段构建中为特定平台交叉编译 - Golang 示例中直接用
GOOS=linux GOARCH=arm64 go build不是必须的，因为 Buildx 会自动挂载对应架构的 QEMU 模拟环境或调用原生节点
执行一次构建，推送全平台镜像到仓库
不再需要分别跑三次 docker build，一条命令完成：
docker buildx build \ --platform linux/amd64,linux/arm64,linux/arm/v7 \ --tag yourname/hello-world:latest \ --push \ .
-
--push会将三个架构的镜像及一个 manifest list 一同推送到 Docker Hub（或其他支持 OCI v2 的 registry） - 推完后，在任意架构机器上执行
docker pull yourname/hello-world:latest，Docker 自动拉取匹配本机的版本
验证多架构镜像是否生效
不依赖运行，仅通过元数据即可确认：
- 查看远程镜像支持的平台：
docker buildx imagetools inspect yourname/hello-world:latest，输出中会列出linux/amd64、linux/arm64等条目 - 在树莓派（ARM64）或 Apple Silicon Mac（ARM64）上拉取并运行，确认容器内
uname -m返回aarch64；在 Intel 服务器上则返回x86_64 - 若用
docker run --rm -it yourname/hello-world:latest /bin/sh -c 'echo $HOSTTYPE'，结果应随宿主机实际架构动态变化
