prefer-make

使用 Make 构建

本项目使用 Makefile。始终优先使用 make 目标，而不是直接运行 go 命令。

规则

1. 先检查 Makefile，再运行任何 go build、go test、go run、go vet、go fmt 或 golangci-lint 命令。查找对应的目标。
2. 使用 Makefile 目标，而不是直接运行 go 命令。例如：
   • 使用 make build，而不是 go build ./...
   • 使用 make test，而不是 go test ./...
   • 使用 make lint，而不是 golangci-lint run
   • 使用 make run，而不是 go run main.go
   • 使用 make fmt，而不是 go fmt ./...
3. 运行 make help 以查找目标。 如果运行失败，请直接阅读 Makefile。
4. 仅当任务没有相关的 Makefile 目标时，才回退到直接运行 go 命令。

验证流程

1. 执行前，通过检查 make help 的输出或 Makefile，确认目标存在。
2. 执行后，确认命令以状态码 0 退出，并生成预期输出。

需要留意的常见错误

• 未经检查就假定目标名称。 不要猜测存在 make unit-test，请阅读 Makefile。不同项目的目标名称可能不同。
• 为已设置相关标志的 make 目标添加标志。 例如，如果 Makefile 已传入 -race，就不要运行 make test ARGS="-v -race"。添加标志前先检查目标的具体操作。
• 当 Makefile 中存在接受包参数的目标时，仍针对子集运行原始 go test ./specific/pkg/...。例如，可以运行 make test PKG=./specific/pkg/...。