多阶段构建必须用 from 多次声明，因构建依赖 go 工具链和模块缓存，而运行只需纯净 linux 环境；单阶段即使设 cgo_enabled=0 仍可能引入动态链接，导致运行失败。
多阶段构建为什么必须用 FROM 多次声明
Go 编译产物是静态二进制，但构建过程依赖 go 工具链、GOPATH、模块缓存等，运行时却只需要一个干净的 Linux 环境。不分离构建和运行阶段，镜像会带上 /usr/local/go、go mod cache、甚至 git，体积轻易破 1GB。
- 第一阶段用
golang:1.22-alpine（或:bookworm）编译，执行go build -a -ldflags '-extldflags "-static"' -o /app/main . - 第二阶段必须用
FROM alpine:latest或scratch，否则没真正瘦身 - 如果只写一个
FROM，哪怕加了CGO_ENABLED=0，go build仍可能偷偷拉动态链接库，导致运行时报no such file or directory
COPY --from 的路径必须严格匹配构建阶段的输出位置
很多人卡在“文件复制不到”，其实是阶段名或路径写错。Docker 不会自动猜你上一阶段把二进制放哪了——它只认你 COPY 指令里写的绝对路径。
- 构建阶段里用
go build -o /tmp/main .，那下一阶段就得写COPY --from=builder /tmp/main /app/main - 别用相对路径：
COPY --from=builder ./main /app/会失败，--from只支持绝对路径 - 阶段名不写默认是数字索引（如
--from=0），但显式命名更安全：FROM golang:1.22 AS builder - 如果用
scratch做基础镜像，COPY后必须确保二进制是纯静态链接，否则启动就报standard_init_linux.go:228: exec user process caused: no such file or directory
Alpine vs scratch：选哪个取决于你是否需要调试工具
scratch 镜像只有 0 字节，但连 sh、ls、strace 全都没有。线上出问题没法 docker exec -it 进去查。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 开发/测试环境优先用
alpine:latest：体积约 5MB，自带sh和apk，可临时装curl或netstat - 生产环境用
scratch更极致，但得提前验证：用file ./main确认输出是statically linked；用ldd ./main确认返回not a dynamic executable - 别在
scratch阶段加RUN apk add xxx——它没包管理器，指令直接报错
Go 模块缓存和 vendor 目录怎么避免重复下载
Docker 构建时每层都是只读快照，go mod download 如果放在 COPY . . 之后，只要源码有任意改动（比如改了个空格），缓存就失效，重新拉一遍所有依赖。
- 先
COPY go.mod go.sum .，再RUN go mod download，利用 Docker 层缓存机制 - 如果项目用了
vendor，就COPY vendor vendor，跳过go mod download，但得确保go build -mod=vendor - 别在构建阶段设
GO111MODULE=off：Go 1.16+ 默认开启，关了反而可能因 GOPATH 冲突找不到包 -
go build加-trimpath，去掉编译路径信息，让镜像更小、更可复现
最常被忽略的是构建时的 GOOS 和 GOARCH ——本地是 macOS ARM64，不显式指定就可能编出 darwin/arm64 二进制，扔进 Linux 容器里根本跑不起来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
