Docker 默认按宿主机架构自动拉取匹配镜像（如M1 Mac拉arm64、Intel机器拉amd64），但必须镜像已发布多架构manifest list才支持--platform指定；否则报错“no matching manifest”。
直接拉取或运行镜像时，Docker Desktop 默认按宿主机架构自动匹配（比如 M1 Mac 拉 nginx 就是 arm64，Intel Windows 就是 amd64），但你无法靠 docker run 或 docker pull 命令本身强制指定目标平台——必须用 docker buildx 构建阶段控制，或用 --platform 显式声明（仅对支持多架构的镜像有效）。
docker pull 时怎么指定平台
只有镜像本身发布了 manifest list（即“多架构清单”），你才能在 pull 阶段指定平台。否则会报错 no matching manifest for linux/arm64 in the manifest list entries。
- 确认镜像支持多架构：运行
docker buildx imagetools inspect nginx:latest，看输出中是否列出多个Platform条目（如linux/amd64、linux/arm64） - 显式拉取指定平台镜像：
docker pull --platform linux/arm64 nginx:latest（注意：不是arm64，而是完整平台标识linux/arm64） - 如果拉取失败且提示
manifest unknown，说明该 tag 根本没发布对应架构版本，此时--platform无效，得换镜像或自己构建
docker run 时怎么指定平台
docker run 不接受 --platform 参数——这个选项只存在于 buildx build 和 pull 中。运行阶段能做的只有两件事：
- 确保镜像已存在本地且架构匹配（比如你
pull --platform linux/arm64过了，再run就会用那个arm64层） - 若宿主机是 x86_64，但想运行 arm64 镜像，需依赖 QEMU 模拟：Docker Desktop 默认已启用，但性能差、部分系统调用不兼容（比如某些内核模块、
seccomp策略） - 运行前可用
docker inspect IMAGE_ID | grep -i arch确认实际架构，避免误判
docker build 时如何控制输出架构
普通 docker build 只能构建本机架构镜像；跨架构构建必须用 buildx，且依赖 WSL2 + QEMU（Windows）或 Rosetta 2（macOS Intel）。
- 先启用构建器：
docker buildx create --use --name mybuilder --platform linux/amd64,linux/arm64 - 构建并推送到仓库：
docker buildx build --platform linux/amd64,linux/arm64 -t yourname/app:latest --push . - 关键点：
--platform决定构建目标，不是运行时行为；FROM --platform=$BUILDPLATFORM在 Dockerfile 中可让基础镜像也按目标平台拉取（避免构建中途因基础镜像架构错乱失败） - 不加
--push时，镜像只存在 buildx 构建器内部，docker images看不到
容易被忽略的架构陷阱
最常被跳过的其实是基础镜像本身的平台兼容性。比如写 FROM python:3.10-slim，它默认只提供 amd64，在 M1 上构建会静默 fallback 到模拟模式，导致构建慢、运行卡顿甚至崩溃。
- 始终显式指定基础镜像平台：
FROM --platform=linux/arm64 python:3.10-slim-bookworm - 检查 base 镜像是否真有对应架构：
docker buildx imagetools inspect python:3.10-slim-bookworm - Docker Desktop 设置里勾选 “Use the new Virtualization framework”（macOS Sonoma+）或确保 WSL2 已设为默认（Windows），否则
buildx无法加载 QEMU
