GOBIN和GOPROXY必须按项目隔离设置，GOBIN推荐设为$PROJECT_DIR/out/bin避免跨项目污染，GOPROXY依网络策略选https://goproxy.cn或direct，GO111MODULE须显式设on/off。
GOBIN 和 GOPROXY 必须按项目隔离设置
全局设 GOBIN 或 GOPROXY 会导致多项目构建冲突：老项目 go install 输出覆盖新项目二进制，私有代理配置让内部模块拉取失败。GoLand 里必须走项目级环境变量，路径写法要可预测：
- GOBIN 推荐设为
$PROJECT_DIR/out/bin（不依赖$GOPATH，避免跨项目污染） - GOPROXY 设为
https://goproxy.cn或direct，按项目实际网络策略选 - GO111MODULE 必须显式设为
on或off，不能留空——留空会继承系统值，导致无go.mod项目报go: modules disabled
Makefile 中的 BUILD 变量要嵌入二进制而非仅打印
BUILD := $(shell git rev-parse --short HEAD) 这行本身只在 Makefile 解析时执行一次，若不传给 go build -ldflags，运行时就拿不到版本号。常见错误是只定义没注入：
- 正确写法：
go build -ldflags "-X main.buildVersion=$(BUILD)" -o bin/app ./cmd - 对应 Go 代码中需声明变量：
var buildVersion string（必须是包级变量，且路径匹配-X参数格式） - 如果项目用
main包外的子包存版本变量，-X的导入路径要写全，比如-X github.com/your/app/version.Build=$(BUILD)
交叉编译时 GOOS/GOARCH 不能靠 shell export 临时生效
在终端里 export GOOS=windows 再跑 go build 看似可行，但 IDE 的 Run/Debug 配置、CI 脚本或 Makefile 并不读取该 shell 环境。真正可控的方式是：
- 直接在命令中指定：
GOOS=linux GOARCH=arm64 go build -o bin/app-linux-arm64 ./cmd - Makefile 中定义变量：
GOOS ?= linux，调用时make GOOS=darwin build - GoLand Run Configuration 的 Environment variables 栏里单独填
GOOS=windows;GOARCH=amd64，优先级高于项目级环境变量
go build 的 -ldflags 注入变量容易漏掉 -w -s 优化
用 -X 注入版本号时，默认二进制含调试信息，体积大且暴露符号。上线前必须加裁剪参数：
-
-w：去掉 DWARF 调试信息 -
-s：去掉符号表 - 组合写法：
go build -ldflags "-w -s -X main.buildVersion=$(BUILD)" -o bin/app ./cmd - 注意顺序：
-w -s要放在-X前面，否则部分 Go 版本会忽略
构建变量不是设完就完事，关键在“是否被实际构建流程消费”。GOBIN 路径写错、-ldflags 没配对变量、交叉编译环境没进 Run/Debug 配置——这些点不验证输出结果，很容易上线后才发现版本号为空或二进制跑在错误平台。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
