Go二进制默认静态链接，不依赖libc等系统库（除非启用cgo），故可直接运行于scratch镜像；需禁用cgo并显式指定GOOS=linux确保跨平台兼容性。
为什么 Go 二进制不需要运行时依赖？
Go 默认静态链接，go build 产出的是单个可执行文件，不依赖 libc、glibc 等系统库（除非显式启用 cgo）。这是多阶段构建能大幅减小镜像体积的根本前提。
常见错误：没关 cgo 就往 scratch 里塞二进制，启动报 no such file or directory——其实是动态链接器缺失，不是文件没找到。
- 确认是否静态编译：
ldd your-binary输出not a dynamic executable才安全 - 强制静态构建（推荐）：
CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o app . - 如果必须用
cgo（如调用 C 库），就别用scratch，改用alpine:latest并安装对应依赖
Dockerfile 多阶段写法（Go 官方推荐模式）
典型结构是「构建阶段 + 运行阶段」，中间不保留任何 Go 工具链或源码。
关键点在于：第一阶段用 golang:1.22-alpine（或对应版本）做编译；第二阶段用 scratch 或 alpine 拷贝二进制，不复制 $GOPATH、go.mod、测试文件等无关内容。
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
FROM golang:1.22-alpine 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 /usr/local/bin/app . <p>FROM scratch COPY --from=builder /usr/local/bin/app /app EXPOSE 8080 CMD ["/app"]
-
AS builder是命名构建阶段，供后续--from引用 -
GOOS=linux必须显式指定，否则在 macOS/Windows 上构建会生成宿主机平台二进制 -
COPY --from=builder只能拷贝已存在的文件路径，不能用通配符或相对路径别名
如何避免 COPY 失败或运行时 panic？
最常踩的坑是路径不一致或权限问题。构建阶段生成的二进制若带调试符号或未 strip，可能在 scratch 中因缺少 /proc 或 /dev/null 导致某些日志/trace 功能失败，但不会直接 crash。
- 检查二进制是否真能运行：
docker run --rm -it your-image /app -h，而不是只看docker build是否成功 - 如果程序用
os.Getwd()或读取当前目录配置，需注意scratch镜像无默认工作目录，务必用WORKDIR显式设置 - Web 服务监听要绑定
0.0.0.0:8080，不能写localhost:8080，否则容器内无法被外部访问 - 时间区问题：
scratch无/etc/timezone，time.Now()仍可用，但time.LoadLocation("Asia/Shanghai")会返回 error
要不要加 .dockerignore？
要，而且非常关键。不加会导致 go build 阶段意外包含 node_modules、.git、vendor 等大目录，显著拖慢构建速度，甚至触发内存溢出。
最小必要 .dockerignore 内容：
**/*.md **/*.txt .git .gitignore README* Dockerfile .dockerignore node_modules vendor *.go~
特别注意：go mod vendor 后若仍保留 vendor/ 目录，又没加进 .dockerignore，Docker 会把它一并发送给 daemon，而 go build 默认优先用 vendor，容易掩盖模块版本不一致问题。
