结论：不清理/go/pkg、/root/.cache/go-build和.git，哪怕用了多阶段构建，最终镜像体积仍可能膨胀3–5倍；因Docker不会自动清空前阶段残留文件，.dockerignore漏配或builder末尾未显式rm -rf会导致这些目录被误带入或固化在镜像层中。
直接说结论：不清理 /go/pkg、/root/.cache/go-build 和 .git，哪怕用了多阶段构建，最终镜像体积仍可能膨胀 3–5 倍——不是“没优化”，而是“删得不干净”。
为什么最终镜像里还有 /go/pkg 或 .git 目录
常见错误是只关注 COPY 二进制，却忽略 builder 阶段残留的 Go 构建产物。Docker 多阶段构建不会自动清空前一阶段的文件系统；它只是不把 builder 的整个文件系统带入 final 阶段——但如果你在 builder 阶段没显式 rm -rf，那些目录就还躺在 builder 镜像层里，且可能被误 COPY 进 final（比如写错路径或用 COPY . .）。
更隐蔽的是：.git 不会被 docker build 自动排除，除非你提前用 .dockerignore 列出。实测一个中型 Go 项目，.git/ 占 12MB 左右，而最终镜像才 15MB，等于白加了 80% 体积。
-
.dockerignore必须包含：.git、.gitignore、testdata/、examples/、vendor/（如果不用 vendor）、go.mod（runtime 阶段不需要） - 别在 Dockerfile 里补救，比如
RUN rm -rf .git——这只会新增一层“删 .git”，实际体积没减 - 验证是否生效：
docker run --rm -it <image> find / -name ".git" 2>/dev/null，有输出就说明没拦住
builder 阶段末尾必须执行的清理命令
很多 Dockerfile 写完 go build 就直接跳到下一阶段，结果 /go/pkg、/root/.cache/go-build 全部固化进 builder 镜像层——哪怕 final 阶段没 COPY 它们，这些层仍存在于镜像历史中，影响拉取和扫描。
立即学习“go语言免费学习笔记（深入）”；
go build -trimpath 只处理源码路径硬编码，不删缓存，也不影响 /go/pkg/mod/cache。真正要删的是三类东西：
-
rm -rf /go/pkg /go/src /root/.cache/go-build（标准清理） -
rm -rf /go/pkg/mod/cache（必须紧接go mod download后执行，否则 cache 会随 builder 镜像固化） - 如果用了
go mod vendor，确保vendor/只存在于 builder 阶段，final 阶段连目录结构都不该存在
CGO_ENABLED=0 和 -ldflags="-s -w" 不是可选，是必开
默认编译的 Go 二进制含调试符号、DWARF 信息、以及 CGO 链接的 libc 路径，导致二进制本身变大，且在 Alpine 或 scratch 上运行时可能因 musl/glibc 不兼容报错。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
关键参数组合必须同时生效：
-
CGO_ENABLED=0：禁用 CGO，强制静态链接（不依赖系统 C 库） -
-ldflags="-s -w"：-s去除符号表，-w去除 DWARF 调试信息 -
-a：强制重新编译所有依赖（含标准库），避免隐式动态链接残留 -
GOOS=linux：明确目标平台，避免跨平台编译污染
示例编译命令：CGO_ENABLED=0 GOOS=linux go build -a -ldflags="-s -w" -o main .
docker builder prune --all -f 是 CI 环境里的保命操作
docker build --no-cache 不等于清缓存。它只跳过指令层复用，但之前构建生成的中间镜像层（比如某次 RUN go mod download 写入的层）依然留在本地磁盘，下次构建时 Docker 仍要扫描它们——既拖慢构建，又占用空间。
CI 流水线每次构建前建议加一步：
docker builder prune --all -f
这会彻底删除所有构建缓存，避免旧缓存污染新构建。尤其当 go.mod 频繁变更、或团队共用构建节点时，漏掉这步极易导致镜像体积忽大忽小、构建时间飘忽不定。
最易被忽略的点：即使你写了完美的多阶段 Dockerfile，只要 builder 阶段没清理缓存、.dockerignore 漏掉 .git、或者忘了关 CGO，最终镜像就会悄悄胖起来——而且这种“胖”很难一眼看出，只能靠 docker history 逐层 inspect 才能定位。
