不能直接用golang:alpine作运行镜像，因其默认动态链接glibc，而Alpine使用musl libc不兼容，导致启动报“no such file or directory”；必须用golang:alpine作为builder阶段并设CGO_ENABLED=0静态编译，再将二进制复制到alpine或scratch运行镜像中。
docker build是最直接的起点，但盲目执行它大概率打出一个 300MB+、带完整 Go SDK 的臃肿镜像——这不是容器化，是“把开发机塞进容器”。
为什么不能直接用 golang:alpine 作运行镜像
常见错误：Dockerfile 只写一行 FROM golang:alpine，然后 COPY 二进制进去就 ENTRYPOINT。结果容器启动报错：standard_init_linux.go:228: exec user process caused: no such file or directory。
原因很实在：你本地 go build 出来的二进制默认动态链接 libc，而 Alpine 用的是 musl libc，不兼容。
解决路径只有两条：
- 在 Alpine 环境里编译（即用
golang:alpine作为 builder），并设CGO_ENABLED=0强制静态链接 - 或改用 Debian/Ubuntu 基础镜像（如
debian:slim），但它体积翻倍，且仍需注意libc版本对齐
CGO_ENABLED=0 不是万能开关，得看项目有没有 C 依赖
如果你的 Go 项目用了 cgo（比如依赖 net 包里的 DNS 解析、sqlite3、openssl 或某些硬件驱动封装），关掉 cgo 会导致编译失败或运行时 panic。
验证方式很简单：
- 本地跑
CGO_ENABLED=0 go build -o test .，成功 → 可安全静态编译 - 报错类似
undefined reference to 'getaddrinfo'或import "C" requires cgo→ 必须保留cgo
保留 cgo 时，就不能用 scratch 或纯 Alpine 运行镜像，得选 gcr.io/distroless/static:nonroot 或 alpine:latest 并提前装好 musl 和必要共享库（如 apk add --no-cache ca-certificates）。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
多阶段构建不是“炫技”，是控制镜像分层和体积的关键
一个典型可靠结构：
FROM golang:1.23-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server . FROM alpine:3.20 RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /server . EXPOSE 8080 CMD ["./server"]
注意几个硬性细节：
-
go.mod和go.sum必须先COPY再go mod download，否则 Docker 构建缓存失效，每次重下依赖 -
-ldflags="-s -w"去掉调试符号和 DWARF 信息，能减小 20%~30% 二进制体积 - 第二阶段别用
scratch直接跑 —— 它没有/bin/sh，docker logs、docker exec -it全失效，排障成本陡增
本地测试通过 ≠ 容器内可用，必须验证运行时行为
构建完别急着推 registry，先做三件事：
- 跑一次
docker run --rm <image> go version</image>（如果镜像含 Go）或ls -l /server确认文件存在 - 用
docker run --rm -p 8080:8080 <image></image>启动，curllocalhost:8080看 HTTP 响应 - 检查日志是否含 panic、DNS 超时、证书错误（Alpine 默认无 CA 证书包，
ca-certificates必装）
最容易被跳过的点：时区和语言环境。Go 程序若用 time.Now().Format("2006-01-02") 输出时间，默认是 UTC。加一句 ENV TZ=Asia/Shanghai 和 RUN apk add --no-cache tzdata，再 COPY /usr/share/zoneinfo/Asia/Shanghai /etc/localtime 才算真正落地。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
