Buildx多平台构建比本地交叉编译快，因其基于BuildKit并行处理多平台阶段、共享跨架构缓存，并通过多阶段Dockerfile复用builder阶段产物（如Go静态二进制），避免重复下载工具链和依赖；单阶段镜像则无法受益。
buildx 多平台构建为什么比本地交叉编译快
因为 Buildx 默认启用 BuildKit，能并行处理多个平台的构建阶段，且共享缓存（即使跨架构）。而传统 GOOS/GOARCH 交叉编译是串行的，每次都要重跑整个构建流程，且无法复用依赖下载、编译中间产物等步骤。
更关键的是：Buildx 在多阶段 Dockerfile 中可让每个平台复用同一份 builder 阶段输出（比如 Go 编译结果），只在最终运行阶段切换基础镜像 —— 这比纯命令行交叉编译更贴近真实部署环境，也更容易验证运行时兼容性。
必须用多阶段 Dockerfile，否则白搭
单阶段镜像（比如直接 FROM golang:1.23 然后 RUN go build）会让每个平台都重复下载 Go 工具链和依赖，完全浪费 Buildx 的缓存能力。
正确写法是分离编译与运行阶段：
立即学习“go语言免费学习笔记（深入）”；
FROM golang:1.23 AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o server . FROM alpine:3.20 RUN apk --no-cache add ca-certificates COPY --from=builder /app/server /usr/local/bin/server CMD ["server"]
注意：CGO_ENABLED=0 和 GOOS=linux 是为了生成纯静态二进制，避免运行时 libc 不兼容；--from=builder 能跨平台复用编译产物，这才是加速核心。
buildx build 命令里 --platform 和 --push 必须配对用
如果你只加 --platform linux/amd64,linux/arm64 却不加 --push，Buildx 默认不会加载镜像到本地 Docker 引擎（因为多平台镜像无法被本地 docker images 正确识别），你将拿不到可用镜像，也测不了。
实操建议：
- CI/CD 流水线中一律用
--push直接推 registry，靠 manifest list 分发 - 本地调试想快速验证某平台，改用
--load --platform linux/arm64（但仅限单平台，多平台 +--load会报错） - 别信
docker buildx build --load --platform ...能同时加载多个平台镜像 —— 它只会加载最后一个平台，其余丢弃
QEMU 模拟慢？优先换 builder 节点而非硬扛
在 x86 主机上构建 linux/arm64 时，QEMU 模拟会让 Go 编译变慢（尤其涉及 cgo 或大量反射的项目），这不是配置问题，是硬件限制。
真正有效的提速方式是：
- 在 CI 中为 ARM64 单独申请一台
arm64runner（如 GitHub Actions 的ubuntu-latest默认是 amd64，但macos-latest或自建arm64节点可原生运行） - 用
docker buildx create --name hybrid --driver docker-container --node amd64-node --node arm64-node创建混合构建器，让不同平台任务分发到对应硬件节点 - 避免在本地反复跑
--platform linux/arm64调试，改用docker run --platform linux/arm64 -it --rm golang:1.23手动验证编译逻辑
最常被忽略的一点：Buildx 的缓存是按 platform + 构建上下文哈希隔离的。哪怕你只改了一行 .dockerignore，所有平台的缓存都会失效 —— 所以 .dockerignore 文件本身要足够稳定。
