构建多架构 docker 镜像需用 --platform 指定目标架构（如 linux/arm64），依赖基础镜像的多架构 manifest list；from --platform=linux/arm64 可强制单阶段架构，需 docker 20.10+；跨架构构建须启用 qemu-user-static。
在 Dockerfile 中使用 FROM 指令时，若需构建多架构镜像（如 arm64、amd64），不能仅靠写死镜像名，而要结合构建上下文和平台声明来动态拉取对应架构的基础镜像。
用 --platform 显式声明目标架构
Docker 构建时可通过 --platform 参数指定目标 CPU 架构，Docker 会自动匹配该架构的镜像层。即使基础镜像（如 alpine:latest）是多架构 manifest 列表，Docker 也会根据该参数选择对应变体。
- 构建 arm64 镜像：
docker build --platform linux/arm64 -t myapp-arm64 . - 构建 amd64 镜像：
docker build --platform linux/amd64 -t myapp-amd64 . - 确保基础镜像支持目标平台（如官方
debian、ubuntu、alpine都已提供多架构支持）
在 FROM 中使用带平台前缀的镜像名（可选但明确）
对于某些非官方或自建镜像，若未发布标准 manifest list，可直接在 FROM 中写明平台限定的镜像地址，格式为：docker.io/namespace/image:tag@sha256:... 或使用平台别名（需镜像仓库支持）。
- 例如：
FROM --platform=linux/arm64 python:3.11-slim—— 这种写法会强制此 stage 使用 arm64 架构的 python 镜像 - 注意：该语法要求 Docker 20.10+，且只影响当前
FROM行，不影响后续指令执行环境 - 适合混合构建场景（如在 amd64 主机上交叉编译 arm64 二进制）
避免硬编码架构相关的标签（如 -arm64 后缀）
手动维护 python:3.11-slim-arm64 这类标签容易出错，也不符合 OCI 标准。官方镜像一般不提供这种后缀变体，而是通过 manifest list + --platform 自动分发。
- 错误示例：
FROM python:3.11-slim-arm64（该镜像通常不存在） - 正确做法：依赖镜像仓库的多架构 manifest，配合构建参数驱动
- 可用
docker manifest inspect python:3.11-slim查看支持的架构列表
本地构建时确认 QEMU 和 binfmt 支持（尤其跨架构）
在 x86_64 机器上构建 arm64 镜像，需要 Docker 能运行 arm64 二进制（如 RUN 指令中的命令）。这依赖 qemu-user-static 和内核 binfmt_misc 注册。
- 一键启用：
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes - 验证是否生效：
cat /proc/sys/fs/binfmt_misc/qemu-aarch64应存在且 enabled - 若跳过此步，构建可能在 RUN 阶段失败（“exec format error”）
