答案是确保go命令在项目根目录执行：用cd $$(dirname $$(realpath $(firstword $(makefile_list)))) && go build -o ./bin/app ./cmd/app，并提前mkdir -p ./bin，显式指定包路径而非.。
make build 报 cannot find module 怎么办
这不是 Makefile 写错了，而是 Go 模块系统找不到 go.mod 所在路径。常见于：你在子目录执行 make build，当前工作目录不是模块根（即没有 go.mod 的那层）。
解决方法只有一条：确保所有 go 命令都在项目根目录运行。最稳写法是：
- 用
$(MAKEFILE_LIST)定位 Makefile 位置，再用cd $$(dirname $$(realpath $(firstword $(MAKEFILE_LIST)))) && go build ... - 或更简洁地，在每个目标第一行加
cd $$(dirname $$(realpath $(firstword $(MAKEFILE_LIST)))) ; \，后面接命令 - 别依赖“当前目录刚好对”，CI 或并行构建时会出错
交叉编译输出名总被覆盖？
写成 GOOS=linux go build -o bin/app . 和 GOOS=darwin go build -o bin/app .，结果后一次直接覆盖前一次——因为输出路径没区分平台。
必须把平台信息嵌进 -o 路径：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确写法：
-o bin/app-$(GOOS)-$(GOARCH)，例如bin/app-linux-amd64 - Windows 需手动加后缀：
-o bin/app-windows.exe，Makefile 不会自动补 - 建议统一变量定义：
GOOS ?= linux、GOARCH ?= amd64，避免硬编码重复
版本号和时间戳为什么每次 make 都一样？
$(shell ...) 在 Make 解析阶段就执行一次，所有 target 共享同一个值；如果写在 recipe 行里（比如 @go build -ldflags="-X main.time=$$(date)"），又会导致每次重跑、缓存失效。
预计算才是正解：
- 顶部定义：
VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev") - 同理：
BUILD_TIME := $(shell date -u +"%Y-%m-%dT%H:%M:%SZ") - 然后组合进
LDFLAGS：LDFLAGS := -ldflags="-X main.version=$(VERSION) -X main.buildTime=$(BUILD_TIME) -s -w"
go build 路径写错导致 no Go files in current directory
Go 不会自动找 main 函数，它只编译你明确指定的包路径。比如主程序在 cmd/app，却写 go build -o bin/app .，就会失败——. 下没有 main.go，只有 go.mod 和 cmd/ 目录。
永远显式写包路径：
-
go build -o ./bin/app ./cmd/app（推荐） - 别用
./...或.，可能误编译测试文件、mock 包甚至vendor里的东西 - 输出目录提前创建：
mkdir -p ./bin必须出现在build目标第一行，否则构建中断
module github.com/user/repo 声明，必须对应物理路径 /path/to/repo，而 Makefile 不校验这个。一旦 clone 后没进对目录就 run make，错误就来了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
