Go项目用Makefile管理需显式控制GO111MODULE=on、-o指定输出路径、CGO_ENABLED按需启用；测试须限制范围并合并覆盖率；发布要动态取git版本、指定GOOS/GOARCH、生成sha256校验和；clean须精准删除bin及go缓存。
Go 项目用 Makefile 管理，核心不是“要不要用”，而是“怎么避免让 make 成为新坑”。它确实能统一构建入口、屏蔽环境差异、支撑 CI 流水线，但一旦变量没显式控制、路径没提前创建、模块模式没强制开启，make build 就会在不同机器上输出不同结果。
go build 命令必须显式指定 -o 和入口路径
直接写 go build main.go 或依赖当前目录下有 main.go，会导致跨平台构建失败、产物位置不可控、CI 找不到二进制。实际项目里 main.go 往往在 ./cmd/myapp 下，且输出必须可预测。
- 始终用
go build -o ./bin/myapp ./cmd/myapp，不省略-o，不靠GOBIN - 目标命令前加
mkdir -p ./bin，否则make build在空目录首次运行会报错中断 - 别写
go build .—— 它可能编译出错包（比如internal/下的非主包），或漏掉真正要打包的 cmd 目录
GO111MODULE、GOOS、GOARCH 必须每个命令前显式传
Makefile 不继承 shell 的环境变量，CI 容器里 GO111MODULE 可能是空，GOOS 可能是 darwin 却想产出 Linux 二进制。静默降级到 GOPATH 模式或编译出错平台，都是因为没盯住这三个变量。
- 所有
go命令前加GO111MODULE=on，例如：GO111MODULE=on go build -o ./bin/app ./cmd/app - 交叉编译时，用
GOOS=linux GOARCH=amd64 go build，而不是先export GOOS=linux—— export 不跨 target 生效，还可能污染后续命令 - 若项目含 C 依赖（如 SQLite、OpenSSL），构建时需
CGO_ENABLED=1；纯静态分发则设CGO_ENABLED=0，但得确认依赖是否支持
test 和 clean 容易漏掉关键约束
make test 在本地跑过，在 CI 上超时或 panic，往往是因为没控制范围、没设超时、没清缓存；make clean 看似删了 bin/ 就完事，其实 go test 的缓存、cgo 的中间文件、模块下载缓存都还在，下次构建行为可能被干扰。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 测试范围用
go test $(shell go list ./ | grep -v '/vendor\|/gen\|/mocks')，比./...更准，避免扫到生成代码或第三方 mock - 必须加
-timeout 30s，防止某个测试卡死阻塞整个流程 -
clean要三清：rm -rf -f ./bin ./coverage.out+go clean -cache -modcache -testcache -caches - 别在
clean里调go mod tidy—— 那是依赖管理动作，和清理无关，混在一起会让命令语义混乱
版本注入和覆盖率不能只靠单条命令
把 -ldflags="-X main.version=$(VERSION)" 写进 build 目标看似简单，但 VERSION 若写死或没处理 --dirty，就失去追踪价值；覆盖率报告若只用 -cover，只能看到单个包，合并多个子包结果需要两步走。
-
VERSION应动态取：VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo dev)，确保带未提交标记 - 覆盖率：先
go test -covermode=count -coverprofile=coverage.out ./pkg/ ./cmd/，再go tool cover -func=coverage.out或-html=coverage.html - 如果项目用了
go.work（多模块 workspace），go list ./会失效，得手动解析go.work文件或改用go list all
最常被忽略的是：Makefile 本身无法感知 go.mod 变更。改了依赖，make build 还是走旧缓存，除非你把 go.mod 和 go.sum 显式列为构建目标的 prerequisites，或者在 CI 中强制加 go mod verify 校验一致性。
