应使用 golang:1.22-alpine 等 Alpine 镜像构建 Go 项目，体积仅约 350MB，避免 golang:latest 的 1GB Debian 镜像浪费；含 cgo 依赖时用 apk add build-base openssl-dev，纯 Go 项目设 CGO_ENABLED=0；多阶段构建需严格匹配 COPY 路径与 go build -o 输出路径，WORKDIR 推荐 /app；运行时按需选 Alpine（便于调试）或 distroless（更小、更安全）。
用 Alpine 镜像启动 Go 编译环境，别直接拉 golang:latest
golang:latest 默认是 Debian 基础镜像，体积超 1GB，纯属浪费。Alpine 版本（如 golang:1.22-alpine）仅约 350MB，且自带 apk 包管理器，适合构建阶段使用。
常见错误是把整个 golang:latest 当运行时镜像用——结果镜像里塞了 go toolchain、gcc、git 等一堆编译期才需要的东西，白占空间还增加攻击面。
- 构建阶段必须用
golang:alpine或golang:slim，不能用 full distro 镜像 - 若项目含 cgo 依赖（如 sqlite、openssl），需保留
gcc和对应 dev headers，用apk add --no-cache build-base openssl-dev - 纯 Go 项目一律设
CGO_ENABLED=0，避免引入动态链接库依赖
多阶段构建中 COPY 的路径和权限容易出错
第二阶段从 builder 复制二进制时，COPY --from=builder 的源路径必须与第一阶段 WORKDIR 和 go build -o 输出路径严格一致；否则容器启动报 exec user process caused: no such file or directory——其实是找不到文件，不是权限问题。
典型陷阱：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
go build -o ./bin/app .→ 第二阶段得写COPY --from=builder /app/bin/app .，不是/app/app - Alpine 默认无
/root目录，WORKDIR /root/可能失败，建议统一用/app或/srv - 二进制默认无执行权限？不会。Go 编译产物天然可执行，只要宿主文件系统没挂载
noexec
运行阶段用 distroless 还是 Alpine？看你要不要 curl / apk
Alpine 镜像（alpine:latest）带 apk 和基础工具，方便调试（比如进容器 apk add curl 测健康端点）；但多了 shell 和包管理器，攻击面更大。
distroless（如 gcr.io/distroless/base-debian12）只含 libc 和证书，体积更小（sh 进去、无法 apk、无法 curl ——健康检查必须用 HEALTHCHECK CMD /bin/true 或走 TCP 检查，不能依赖 HTTP 工具。
- 开发/测试环境优先用 Alpine：方便快速验证、抓日志、临时排障
- 生产环境若已配好 livenessProbe（如 TCP socket 检查端口），可用 distroless
- 千万别在 distroless 里写
HEALTHCHECK CMD curl -f http://localhost:8080/healthz——curl不存在，直接 HEALTHCHECK 失败
编译参数不加 -ldflags="-s -w"，二进制白胖 30%
Go 默认生成的二进制包含符号表和调试信息，对容器部署毫无用处，却让体积膨胀 20–40%。尤其在 ARM 设备或边缘场景下，这几十 MB 很关键。
实操建议：
- 构建命令必须加
go build -ldflags="-s -w" -o app .：-s去符号表，-w去 DWARF 调试信息 - 再叠加
-trimpath可进一步清除源码绝对路径痕迹，增强可重现性 - 验证效果：用
file app查是否显示not a dynamic executable；用du -h app对比优化前后大小 - 注意：
-s -w会让 panic 堆栈丢失文件名和行号，线上需权衡——建议仅在最终发布镜像中启用
CGO_ENABLED=0、-ldflags="-s -w"、多阶段 COPY 路径精确、健康检查方式匹配基础镜像这四点闭环控制。少踩一个，镜像就多 10MB。 
