不能直接用go build生成的二进制塞入scratch镜像，因为默认启用cgo时会动态链接libc等系统库，而scratch镜像无任何共享库及动态链接器，导致运行时报“no such file or directory”（实为找不到ld-musl或ld-linux）；必须设cgo_enabled=0并验证ldd输出为“not a dynamic executable”方可安全使用。
为什么不能直接用 go build 生成的二进制塞进 scratch 镜像？
Go 默认静态链接，但启用 cgo（比如用了 net 或 os/user）时会动态依赖 libc。直接丢进 scratch 运行会报错：standard_init_linux.go:228: exec user process caused: no such file or directory——这其实是找不到动态链接器，不是文件不存在。
实操建议：
- 构建前加环境变量：
CGO_ENABLED=0，强制纯静态编译 - 确认没引入隐式依赖：检查是否调用了
user.Lookup、net.DefaultResolver等触发 cgo 的函数 - 用
ldd your-binary验证：输出not a dynamic executable才算真正静态
多阶段构建中如何安全传递构建产物而不留源码和中间工具？
常见错误是把整个 go mod download 缓存或 go build 的临时目录 COPY 进终镜像，导致镜像体积暴涨且含敏感路径信息。
实操建议：
- 第一阶段用
golang:1.22-alpine（非latest）做构建，显式指定 Go 版本避免 CI 意外升级 - 只 COPY 构建产物：
COPY --from=builder /app/main /app/main，不要 COPY 整个/app - 终阶段用
scratch或distroless/static，不带 shell，杜绝sh -c类逃逸风险
FROM scratch 下如何调试“找不到配置文件”这类运行时问题？
scratch 镜像里没有 ls、cat、strace，连错误提示都可能被截断。程序启动失败时，你看到的往往只是 exit code 1。
实操建议：
- 在构建阶段提前验证路径：用
RUN ls -l /app/config.yaml（仅限 builder 阶段） - 终镜像中 embed 配置：用
embed.FS把config.yaml编译进二进制，避免挂载或 COPY 失误 - 启动命令加简单健康检查：
ENTRYPOINT ["/app/main", "-v"]，让程序输出版本后退出，快速确认能否加载自身
微服务镜像要不要加非 root 用户？USER 指令在 scratch 下为何无效？
scratch 是空镜像，没有 /etc/passwd，设 USER 65534 会失败；而 distroless/static 虽有用户系统，但默认没创建非 root 用户。
实操建议：
- 改用
FROM gcr.io/distroless/base-nonroot，它预定义了nonroot:nonroot用户 - 或者在
scratch基础上手动写 passwd 文件（不推荐，增加维护负担） - 关键点：即使加了
USER，也要确保程序监听端口 ≥1024（如:8080），否则仍需NET_BIND_SERVICE权限
最小化不是越小越好，而是去掉所有运行时不需要的东西。最容易被忽略的是：日志输出格式是否适配容器日志采集（比如换行符、时间戳字段）、HTTP 服务是否禁用 HTTP/2（某些 ingress controller 不兼容）、以及健康检查路径是否真能反映服务就绪状态——这些都不会影响镜像大小，但会让部署卡在最后一步。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
