makefile中go构建需用go build -mod=readonly -ldflags="-s -w" -o ./bin/app ./cmd/app；交叉编译显式指定goos/goarch；test目标加-race和-covermode=atomic；clean需删./bin、./dist、coverage.out、go.work；dev热重载应独立为make dev，make run仅执行二进制。
Makefile里怎么写Go构建命令才不踩坑
直接用 go build 没问题，但硬编码 GOOS、GOARCH 或忽略 -mod=readonly 会导致本地能跑、CI失败、交叉编译产物错乱。关键不是“能不能跑”，而是“换环境还稳不稳”。
-
go build -mod=readonly -ldflags="-s -w" -o ./bin/app ./cmd/app：强制模块只读（防意外改go.mod），裁掉调试信息减体积 - 交叉编译必须显式指定
GOOS和GOARCH，比如GOOS=linux GOARCH=amd64 go build ...，不能依赖当前系统默认值 - 避免在 Makefile 里拼接路径用
$(shell pwd)—— Docker 构建时路径错乱，统一用相对路径或$(CURDIR)
test目标为什么总漏跑覆盖率或race检测
Go 的 go test 默认不开启竞态检测，覆盖率也得手动开；写成 go test ./... 看似全量，实则跳过 vendor 和空包，还可能因并行度高掩盖偶发失败。
- 加
-race必须配-gcflags="all=-race"才生效（旧版 Go 要求，1.21+ 可简化为-race单参数） - 覆盖率建议用
go test -coverprofile=coverage.out -covermode=atomic ./...：atomic模式支持并发安全，coverage.out是后续生成报告的输入 - 别用
./...直接扫——排除internal/testdata这类非测试目录，显式列出./pkg/... ./cmd/...
clean目标删不干净，build缓存和临时文件反复干扰
仅 rm -rf ./bin 不够：go build 的构建缓存（$GOCACHE）、测试生成的 coverage.out、go.work 文件、甚至 go.sum 衍生的校验残留都可能让下次构建行为异常。
- 必删项：
./bin、./dist、coverage.out、go.work（如果项目用了工作区） - 慎删
$GOCACHE：CI 中可清，本地开发留着提速；如需清，用go clean -cache -modcache，别直接rm -rf $(go env GOCACHE) - 加
-f参数避免rm报错中断：rm -rf ./bin ./dist coverage.out go.work 2>/dev/null || true
如何让make run支持热重载又不污染生产Makefile
make run 是开发用的，但把它和 make build 混在一起，容易误触发构建逻辑，或把 air、fresh 这类 dev-only 工具打进 Docker 镜像。
立即学习“go语言免费学习笔记（深入）”；
- 开发热重载走独立目标，比如
make dev，内部调用air -c .air.toml，不和run同名 -
make run应严格等价于 “运行已构建的二进制”，不做构建也不起监控：./bin/app -config=config.yaml - 若必须条件判断，用
ifeq ($(origin RUN_ENV),undefined)区分 CI/DEV，而非在run里塞go run回退逻辑
真正麻烦的是环境变量透传和信号转发——make 本身不转发 Ctrl+C 给子进程，exec 启动的程序退出码也可能被吞掉。这些细节不显眼，但一到部署就卡住。
