构建标签、交叉编译与 ldflags 注入版本号怎么做？

一句话结论：用 //go:build 标签做文件级条件编译；用 GOOS/GOARCH（纯 Go 加 CGO_ENABLED=0）做交叉编译；用 go build -ldflags "-X main.version=v1.2.3" 在编译期把版本号注入 string 变量，配合 -trimpath 还能去掉本地路径信息。

构建标签

• 放在文件顶部 package 之前，与 package 之间留空行：//go:build linux && amd64
• 表达式支持 &&、||、!，可组合 GOOS/GOARCH/自定义 tag。
• 惯例：也能用文件名后缀 _linux.go / _windows.go / _amd64.go / _test.go，由 Go 自动匹配。
• go build -tags=foo 启用自定义标签；1.17 前的老写法 // +build 已废弃。

交叉编译

目标	命令示例
Windows	GOOS=windows GOARCH=amd64 go build -o app.exe
Linux ARM	GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build
macOS	GOOS=darwin GOARCH=arm64 go build

• go tool dist list 可查看全部平台组合。
• 涉及 cgo 时交叉编译需要目标平台工具链，通常先 CGO_ENABLED=0 出纯静态二进制。

ldflags 注入版本

// main.go
var (
	version = "dev"    // 无初始化表达式才能被 -X 覆盖
	commit  = "unknown"
)

func main() {
	fmt.Printf("version=%s commit=%s\n", version, commit)
}

go build -trimpath \
  -ldflags "-X main.version=v1.2.3 -X main.commit=abc123" \
  -o app

-X 要求：目标必须是 string 类型变量，包名写完整导入路径（main 包就是 main.version）；-trimpath 去掉构建机绝对路径，让二进制可复现。

常见追问 / 记忆点

• 追问：-X 能注入非 main 包的变量吗？——能，写全导入路径即可，如 -X example.com/m/pkg.version。
• 追问：版本信息一般还打到哪？——常配合 /version 接口与启动日志输出，方便线上核对。
• 记忆点：//go:build 条件编译；GOOS/GOARCH 加 CGO_ENABLED=0 交叉编译；-X "main.version=..." 注入加 -trimpath。