应使用 go build -o ./bin/app ./cmd/app 并前置 mkdir -p ./bin，交叉编译加 GOOS=linux GOARCH=amd64，启用 GO111MODULE=on；test 用 go test $(shell go list ./... | grep -v '/vendor|/gen|/mocks') -timeout 30s；clean 加 -f 参数并执行 go clean -testcache。
Makefile 里怎么写 go build 命令才不踩坑
直接用 go build 没问题，但硬编码 main.go 或忽略 -o 输出路径，会导致跨平台构建失败、二进制名混乱、CI 环境找不到产物。
- 永远用
go build -o ./bin/app ./cmd/app这种显式模块路径写法，别依赖当前目录下有main.go - 输出目录
./bin/必须提前创建，make不会自动建目录，否则构建中断；加一行mkdir -p ./bin到目标依赖里 - 想交叉编译？在命令里加
GOOS=linux GOARCH=amd64，但注意：这些环境变量只对当前命令生效，别写成 export - 如果项目用了 Go Module，确保
GO111MODULE=on显式带上，尤其在旧版 CI 容器里，否则可能静默降级到 GOPATH 模式
如何让 make test 自动跑对包，又快又准
go test 默认只跑当前目录，而大型 Go 项目通常分 internal/、pkg/、cmd/，漏掉某个子包的测试就等于留了盲区。
- 用
go test ./...覆盖所有子模块，但会扫到 vendor 或生成代码；改用go test $(shell go list ./... | grep -v '/vendor\|/gen\|/mocks')更稳 - 加
-race是好事，但只应在本地或专用测试任务里开，CI 主流程默认关掉——它会让执行时间翻倍以上，且某些 cgo 包根本不兼容 - 测试超时容易被忽略：
go test -timeout 30s必须写死，否则个别卡住的测试会让整个make test挂住不动 - 想看覆盖率？别用
go test -cover单次运行，它只覆盖当前包；用go test -coverprofile=coverage.out ./...+go tool cover -html=coverage.out两步走
clean 目标为什么总删不干净 bin/ 和 coverage.out
表面看是 rm -rf bin/ coverage.out 就完事，实际常见三个断点：权限不足、路径不存在报错中断、没清掉 _obj 或 testcache 导致下次构建误复用。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 加
-f参数：rm -rf -f bin/ coverage.out，避免目录不存在时报错退出 - Go 1.21+ 默认启用 test cache，得额外加
go clean -testcache，否则make clean && make test可能跳过真实执行 - 如果用了
cgo，临时文件还藏在$GOCACHE下，一般不用清，但若要彻底重来，可加go clean -cache（注意：这会清掉所有项目的缓存） - 别在
clean:后面直接写命令，一定要另起一行并缩进——Makefile 对空格极其敏感，Tab 和空格混用会报Missing separator
怎么让 make run 支持热重载又不污染正式构建逻辑
make run 是开发态需求，和 make build 的目标完全不同：它要快、要感知文件变化、不能产出正式二进制，更不能跟 CI 流水线共用同一套参数。
立即学习“go语言免费学习笔记（深入）”；
- 别用
go run main.go，它不支持多文件入口；改用go run ./cmd/app，自动识别模块主包 - 热重载必须借助第三方工具，
air是目前最轻量的选择，安装后直接air -c .air.toml；配置里把root设为项目根目录，bin设为./tmp/app，避免和正式./bin/冲突 - 不要把
air写进Makefile的依赖链里，它本身是个长期运行进程；make run应该只是启动命令，终止靠Ctrl+C，而非靠另一个make stop - 如果用了
air，记得在.gitignore加上./tmp/，不然每次热启动生成的临时二进制会被 git 警告
真正麻烦的是环境变量传递和调试符号——go run 默认不带 -gcflags="all=-N -l"，导致 VS Code 调试时断点失效，这个细节八成开发者第一次都会卡住。
