Makefile 中需显式设置 GOOS、GOARCH 和 CGO_ENABLED，避免依赖环境变量；用 $(shell go env GOPATH) 获取路径（注意双写 $）；test 目标加 -short，clean 包含 go clean -cache -modcache -caches。
Makefile 里怎么写 go build 才不踩环境变量坑
Go 工程本地构建失败、CI 上编译出错，八成是 GOOS、GOARCH 或 GOPATH 没显式控制。Makefile 默认不继承 shell 的完整环境，尤其在 CI（如 GitHub Actions）中，go build 可能用错 Go 版本或目标平台。
- 所有
go命令前加env GOOS=linux GOARCH=amd64（按需调整），避免依赖当前 shell 环境 - 用
$(shell go env GOPATH)替代硬编码路径，但注意 Makefile 中$要双写：$$ - 别在
Makefile里 exportGOPATH—— Go 1.16+ 默认启用 module 模式，GOPATH仅影响go install到bin/的行为，不是构建必需 - 示例：
build: \t@env GOOS=linux GOARCH=amd64 go build -o bin/app .
如何让 make test 自动识别 _test.go 且跳过集成测试
go test 默认跑全部 *_test.go，但工程里常混着单元测试和需要 DB/Redis 的集成测试，直接 make test 在 CI 上容易超时或失败。
- 用
-short标志过滤：在测试函数开头加if testing.Short() { t.Skip("skipping integration test") } - Makefile 中定义
test和test-integration两个目标，后者显式传-tags=integration - 避免
go test ./...—— 它会遍历所有子模块，可能触发无关 vendor 包的测试；改用go test ./...前先go list ./... | grep -v '/vendor/'，但更稳的是明确写./cmd/... ./pkg/... - 示例：
test: \t@go test -short -v ./pkg/... ./cmd/...
clean 目标为什么不能只删 bin/ 还得清缓存
只 rm -rf bin/ 看似干净，但 go build 的中间产物（如 $GOCACHE）和 module 下载缓存（$GOPATH/pkg/mod）会导致后续构建行为不一致 —— 比如改了 go.mod 却没生效，或者本地复现不了 CI 的编译错误。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 加
go clean -cache -modcache，它比手动rm -rf $GOCACHE更安全（兼容不同 Go 版本路径） - 如果项目用了 cgo，还得清
go clean -caches（注意是复数caches），否则 C 依赖的编译结果可能残留 - 不要在
clean里加go mod tidy—— 那是依赖管理动作，和清理无关，混在一起会让make clean变慢且不可预测 - 示例：
clean: \t@rm -rf bin/ \t@go clean -cache -modcache -caches
跨平台交叉编译时，CGO_ENABLED=0 不是万能解
想用 make build-linux 编译 Linux 二进制却报 exec: "gcc": executable file not found？关掉 CGO 确实能绕过 C 依赖，但代价是失去 DNS 解析（netgo 不可用）、musl 兼容性问题，甚至某些标准库功能降级。
立即学习“go语言免费学习笔记（深入）”；
- 仅当确定代码完全不调用 C（比如纯 HTTP server + JSON 处理）时，才设
CGO_ENABLED=0 - 若用到
os/user、net（特别是自定义Resolver）、crypto/x509，必须保留CGO_ENABLED=1并配好对应平台的交叉编译工具链（如gcc-mingw-w64） - Mac 上编译 Windows 二进制：先
brew install mingw-w64，再用CC=x86_64-w64-mingw32-gcc - 示例（Linux 构建）：
build-linux: \t@CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o bin/app-linux .
GOOS/GOARCH 和 CGO_ENABLED 的组合影响 —— 同一个 go build 命令，在 Mac 上设 GOOS=linux 时若忘了关 CGO，就会卡在找 gcc；而关了 CGO 又在 Linux 容器里跑 DNS 查询失败，问题会延迟到运行时才暴露。 
