Go二进制能直接运行在scratch上，因其默认静态链接且关闭CGO后不依赖libc等动态库；需设CGO_ENABLED=0、GOOS=linux，并用多阶段构建仅复制二进制到scratch镜像。
为什么 Go 二进制能直接跑在 scratch 上
Go 默认编译出的是静态链接的可执行文件（不依赖 libc），只要关闭 CGO，就能彻底摆脱系统级共享库依赖。这是用 scratch 的前提——否则运行时会报 no such file or directory（实际是找不到 ld-musl 或 ld-linux）。
关键操作只有两步：
– 编译时加 CGO_ENABLED=0
– Dockerfile 里用 FROM scratch 并只 COPY 二进制
- 不关 CGO：默认启用，链接系统
libc，镜像必须带alpine或debian:slim - 开了
net或os/user等包且 CGO 开着，也可能隐式依赖动态库 -
go build -ldflags="-s -w"可进一步删掉调试信息和符号表，减小体积
Dockerfile 写法：多阶段构建 + scratch 最简版
别把 Go 编译环境塞进最终镜像。用多阶段构建，第一阶段装 golang:1.22-alpine（或官方 golang:1.22），第二阶段用 scratch。
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="-s -w" -o /app/server . FROM scratch COPY --from=builder /app/server /server EXPOSE 8080 CMD ["/server"]
-
GOOS=linux必须显式指定，即使你在 Linux 宿主机上构建——Mac/Windows 构建时不然会产出 darwin/windows 二进制 -
-a强制重新编译所有依赖，避免缓存导致 CGO 残留（虽非必需，但更稳妥） -
scratch镜像没有 shell，所以CMD ["./server"]不能写成CMD ./server（后者会调用/bin/sh，不存在）
常见报错和定位方法
跑起来就 panic 或直接 exec format error / no such file or directory？不是代码问题，是构建链路出了偏差。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
exec format error→ 架构不匹配，比如在 Apple Silicon（arm64）上构建却部署到 amd64 服务器；加GOARCH=amd64显式指定 -
standard_init_linux.go:228: exec user process caused: no such file or directory→ 八成是 CGO 没关，或者用了os/exec调外部命令（scratch里啥都没有） - 想查二进制是否真静态：本地运行
ldd ./server，输出not a dynamic executable才安全 - 如果用了
net/http且需要 DNS 解析，scratch缺/etc/resolv.conf和/etc/nsswitch.conf，得在容器启动时挂载或写入（见下条）
进阶注意点：DNS、时区、日志路径这些“隐形依赖”
scratch 干净得过分——没 /etc/hosts、没 /etc/timezone、没 /dev/pts，Go 程序未必崩溃，但行为可能异常。
- DNS：Go 的
net包在 CGO 关闭时走纯 Go DNS 解析器，但依然读/etc/resolv.conf；Docker 默认会注入，但如果用docker run --network none就没了，需手动COPY或挂载 - 时区：
time.Now()在scratch里默认 UTC；要支持本地时区，得在镜像里放/etc/localtime（可从 alpine 阶段COPY --from=builder /usr/share/zoneinfo/Asia/Shanghai /etc/localtime） - 标准输出重定向：
scratch没/dev/stdout符号链接，但 Go 运行时会 fallback 到 fd 1，一般不影响；不过某些日志库硬写路径就会失败
真正最小可行的 scratch 镜像，不是靠“删东西”，而是靠“只放必要东西”。少一步验证，上线后就多一个深夜告警。
