根本原因是makefile未定义build:目标或命名错误；需确保首行为build:且命令用tab缩进，文件名为makefile，路径显式指定如./cmd/myapp，goos/goarch须与go build同行列并用?=设默认值。
Go 项目里写 Makefile 不是为了替代 go build，而是为了管住人、统一环境、避免“本地能跑 CI 报错”这种低级但高频的问题。
make build 报 No rule to make target 'build' 怎么办
根本原因：Makefile 里压根没定义 build: 这个目标，或者名字拼错了（比如写成 Build: 或 build: 前多了空格）。
- 确保第一行是
build:，冒号后至少有一个 Tab 缩进的命令（Makefile 对缩进极其敏感，不能用空格） - 别把
build写在注释里，或藏在条件判断中（Makefile 不支持运行时 if） - 检查文件名是不是
Makefile（首字母大写），不是makefile或GNUmakefile—— 虽然部分系统兼容，但 GNU make 默认只认Makefile - 如果用了自定义文件名，调用时得显式指定：
make -f MyMakefile build
go build 路径写错导致 no Go files in .
Go 工程通常有 cmd/ 目录放 main 包，go build 默认只看当前目录。Makefile 在项目根目录执行时，go build . 就会失败。
- 显式指定包路径：
go build -o ./bin/myapp ./cmd/myapp，别依赖cd cmd/myapp && go build - 用
$(shell go list ./... | grep -v '/vendor/')动态生成包列表，但注意它会扫到internal/下非 main 包 —— 构建只应指向可执行入口 - 如果项目只有一个 main.go 在根目录，也别写
go build main.go，改用go build -o ./bin/myapp .，否则拆包后（比如分出cmd/和pkg/）立刻失效
交叉编译时 GOOS/GOARCH 不生效
常见现象：写了 GOOS=linux GOARCH=arm64 go build，结果生成的还是 macOS 二进制；或 make build GOOS=windows 没反应。
- Makefile 每行命令默认在独立子 shell 中执行，
GOOS=linux; GOARCH=arm64; go build中的变量只作用于前一条命令 - 正确写法是把变量和命令写在同一行：
GOOS=linux GOARCH=arm64 go build -o ./bin/myapp-linux-arm64 ./cmd/myapp - 要支持命令行覆盖，用
GOOS ?= linux定义默认值，再在命令中显式引用：GOOS=$(GOOS) GOARCH=$(GOARCH) go build ... - 加
CGO_ENABLED=0防 libc 依赖，尤其面向 Alpine 容器时 —— 它必须和go build同一行，不能单独 export
test 目标总在 vendor 里跑测试或漏集成测试
go test ./... 会递归扫所有子目录，包括 vendor/ 和 testdata/，既慢又可能失败；而 go test ./ 又只跑当前目录，漏掉 pkg/ 里的单元测试。
- 明确列出要测的模块：
go test -v ./cmd/ ./pkg/ ./internal/，避开vendor/和examples/ - 用
-short标志跳过耗时测试，要求集成测试函数开头写if testing.Short() { t.Skip(...) } - 分离目标：
test跑短测试，test-integration显式加-tags=integration，避免误触发 - 别在
test里自动调go mod tidy—— 它会重写go.sum，让 CI 缓存失效、PR diff 泛滥
最易被忽略的一点：Makefile 里所有路径都该用 ./bin/ 而非 bin/，所有 go 命令前都该加 GO111MODULE=on，哪怕你本地 Go 版本够新 —— CI 环境很可能没设这个，一跑就退回到 GOPATH 模式，直接找不到依赖。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
