go build 必须显式指定包路径，如 ./cmd/app；工作目录需为模块根，否则报 cannot find module；交叉编译输出路径应含平台标识如 bin/app-$(GOOS)-$(GOARCH)，并预计算版本与时间戳。
go build 路径写错，直接报 no Go files in
Go 不会自动找 main 函数，它只编译你明确指定的包路径。Makefile 在项目根目录，而主程序在 cmd/app，却写成 go build -o bin/app .，就会失败——. 下没有 main.go，只有 go.mod 和 cmd/ 目录。
- 永远用显式包路径：
go build -o ./bin/app ./cmd/app，别依赖cd切目录（并发或 shell 环境下不可靠） - 输出目录要提前创建：
mkdir -p ./bin必须出现在build目标里，否则构建中断 - 不推荐
./...或./：可能误编译测试文件、mock 包，甚至 vendor 里的东西
make build 报 cannot find module？根本不是 Makefile 的锅
这个错误和 Makefile 本身无关，是 Go 模块系统在找 go.mod 时路径不对。比如你在 /tmp/myproj 下 git clone 项目，然后从子目录执行 make build，当前工作目录就不是模块根，Go 就找不到 module github.com/user/repo 对应的物理路径。
- 最稳解法：每条
go命令前加切换动作：cd $(shell dirname $(realpath $(firstword $(MAKEFILE_LIST)))) && go build ... - 更干净的做法：把
cd提前到目标第一行，再跟构建命令，避免重复写 - 别信“只要
go.mod在当前目录就行”——Go 要求模块路径（module声明）和实际路径严格匹配，Makefile 不校验这个
交叉编译输出名混乱、互相覆盖？平台标识必须嵌进 -o 路径
很多人写 GOOS=linux go build -o bin/app .，再写 GOOS=darwin go build -o bin/app .，结果 macOS 版本直接覆盖 Linux 版本，下次想打包 release 就只剩一个。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 输出路径带平台标记：
-o bin/app-$(GOOS)-$(GOARCH)，比如bin/app-linux-amd64 - Windows 要手动加
.exe：-o bin/app-windows.exe，Makefile 不会自动补后缀 - 定义变量统一控制：
GOOS ?= linux、GOARCH ?= amd64，再组合使用，避免硬编码重复 - 如果项目含 cgo，记得加
CGO_ENABLED=0，否则交叉编译大概率失败（报exec: "gcc": not found）
版本号和时间戳总对不上？-ldflags 拼接必须预计算
写成 LDFLAGS := -ldflags="-X main.version=$(shell git describe...)" 看似省事，但 $(shell ...) 在 Make 解析阶段就执行一次，所有 target 共享同一个值；更糟的是，如果写进 recipe 行里（比如 @go build $$(shell date)），每次 make 都会重新跑命令，导致依赖判断异常、缓存失效。
立即学习“go语言免费学习笔记（深入）”；
- 时间戳必须顶部预计算：
DATE := $(shell date -u +%Y-%m-%dT%H:%M:%SZ) - 版本号同理：
VERSION := $(shell git describe --tags --always --dirty 2>/dev/null || echo dev) - 拼进
-ldflags时加双引号防空格：-ldflags="-X main.version=$(VERSION) -X main.buildTime=$(DATE) -s -w"
go 命令显式设 GOOS/GOARCH——其他都是锦上添花。 
