Go项目使用Makefile不是替代go build，而是固化重复操作（如fmt+vet+test）、注入版本信息、支持交叉编译及统一开发流程。
Go 项目用 Makefile 不是为了替代 go build，而是把重复、易错、带参数的组合操作固化下来——比如每次提交前必须跑 go fmt + go vet + go test，或者要同时生成 linux/amd64 和 darwin/arm64 两个二进制，手动敲命令既慢又容易漏。
make build 为什么总编译出没版本号的二进制？
因为默认 go build 不注入任何元信息。要让二进制里带上 Git 提交、时间戳或语义化版本，得靠 -ldflags 传给链接器。
- 在 Makefile 里定义变量：
VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev") - 构造链接参数：
LDFLAGS := -ldflags="-X main.version=$(VERSION) -X main.buildTime=$(BUILD_TIME) -s -w" - 构建时显式使用：
go build $(LDFLAGS) -o bin/app . - 注意：
-X后面的包路径（如main.version）必须和你代码里声明的变量完全一致，否则静默失败
make test 总是跳过某些子目录？
go test ./... 看似能递归测试所有包，但实际会跳过 vendor/、examples/、以 _ 或 . 开头的目录——这是 Go 工具链的默认行为，不是 Makefile 的锅。
- 如果想强制包含特定目录，改用显式列举：
go test ./pkg/... ./internal/... - 需要排除某些包时，别依赖
./...的隐式过滤，而应加-run或-skip参数，例如：go test -run '^(TestHTTP|TestDB)$' ./... - CI 场景下建议固定
GO111MODULE=on，避免因本地 GOPATH 设置导致模块加载不一致
跨平台编译（GOOS/GOARCH）为什么本地跑正常，CI 上失败？
常见原因是 CGO 依赖未关闭，或交叉编译目标缺少必要头文件。Linux 上编译 macOS 二进制失败，90% 是因为默认启用了 CGO。
- 生产构建务必设
CGO_ENABLED=0，否则GOOS=darwin GOARCH=arm64 go build会报clang: error: unknown argument - Makefile 中推荐这样写：
build-darwin: CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o bin/app-darwin . - Windows 下若用 WSL 构建，注意路径分隔符和换行符差异，
$(shell ...)调用的命令输出可能含\r，建议统一用tr -d '\r'清洗
最常被忽略的一点：Makefile 里的变量展开发生在 make 解析阶段，而 $(shell ...) 是在每次目标执行前才调用。如果你在 VERSION 变量里用了 git describe，但构建过程中有人切了分支，那个值就不是你预期的“当前 HEAD”了——真要严格绑定，得把 git rev-parse 放到命令行里，而不是变量定义里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
