本地环境必须用 Go 1.21+ + 多阶段 Dockerfile + distroless 基础镜像，否则构建慢、镜像大、启动延迟高；Go 版本需手动从官网下载安装并配置 GOPROXY，Dockerfile 必须拆为 builder、tester、distroless 三阶段。
直接结论：本地环境必须用 Go 1.21+ + 多阶段 Dockerfile + distroless 基础镜像，否则构建慢、镜像大、启动延迟高——这不是优化项，是底线配置。
Go 版本与 GOPROXY 必须手动配，别信包管理器
Ubuntu/Debian 的 apt install golang 默认装的是 1.18 或更老版本，go mod tidy 在新框架（如 go-zero 1.5+、kratos v2.7+）下会报 unsupported version 错误；Mac 上 Homebrew 装的也常滞后。真实项目里，go version 输出必须是 go version go1.21.6 linux/amd64 这类格式。
- 去
https://go.dev/dl/下载go1.21.6.linux-amd64.tar.gz（或对应系统版本），解压到/usr/local/go - 把
/usr/local/go/bin加进$PATH，并执行go env -w GOPROXY=https://goproxy.cn,direct - 验证：
go mod download github.com/zeromicro/go-zero@v1.5.4不卡住、不报 404 就算过
Dockerfile 多阶段构建不能只写两个 FROM
常见错误是写成 FROM golang:alpine AS builder → COPY . . → go build → FROM alpine:latest → COPY --from=builder /app/main /app/main。这看着“多阶段”，但实际没省掉 builder 镜像里所有 Go 工具链和 C 标头，最终镜像仍超 30MB。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 真正有效的写法要拆三段：
FROM golang:1.21-alpine AS builder（仅编译）、FROM golang:alpine AS tester（仅跑 test，不进最终镜像）、FROM gcr.io/distroless/static-debian12（纯二进制运行，无 shell， -
go build必须加-ldflags="-s -w"：去掉调试符号和 DWARF 信息，体积直降 30%～40% - 如果用了 cgo（比如连接 PostgreSQL 的 pq 驱动），得在 builder 阶段装
musl-dev，并在CGO_ENABLED=1下构建；否则 distroless 镜像跑不起来
Makefile 里 build 目标要区分 local 和 release
开发时需要快速迭代，go run cmd/main.go 是最快的；但 CI 流水线里必须用 go build 产出静态二进制。混用会导致本地能跑、CI 构建失败，或者反过来——镜像里跑的是未加 -ldflags 的 debug 版本，内存占用翻倍。
立即学习“go语言免费学习笔记（深入）”；
- 推荐 Makefile 片段：
build-local:→go run cmd/main.gobuild-release:→CGO_ENABLED=0 go build -ldflags="-s -w" -o bin/app ./cmd/main.go - 别在
build-release里调go test：单元测试应单独 target（如test-unit），避免拖慢镜像构建 - 如果项目含 protobuf，
protoc-gen-go和protoc-gen-go-grpc要在 builder 阶段安装，而不是本地全局装——否则不同人环境不一致
最容易被忽略的是：distroless 镜像里没有 /bin/sh，所以 docker run -it your-image sh 必然失败；健康检查（healthcheck）必须用 curl -f http://localhost:8080/healthz 这类 HTTP 方式，不能写 cmd: [ "sh", "-c", "ls /app" ]。
