用 -ldflags 注入版本信息时，变量必须是可导出的全局变量
Go 的 -ldflags 只能修改已声明且首字母大写的包级变量（即导出变量），小写变量会被链接器忽略，注入后仍是零值。常见错误是定义了 var version = "dev"，结果运行时打印出来永远是空字符串或默认零值。
- 必须写成
var Version = "dev"或var BuildTime string - 变量类型只能是
string、int、bool等基础类型，不支持 struct 或 map - 推荐统一放在
main包里，避免跨包符号解析失败 - 注入命令示例：
go build -ldflags="-X main.Version=v1.2.0 -X 'main.BuildTime=2024-05-20'"
-ldflags -s -w 确实能减体积，但会丢失调试能力
-s 去除符号表，-w 去除 DWARF 调试信息，两者合用通常能减少 20%–40% 二进制体积。但副作用明显：panic 堆栈不再显示文件名和行号，pprof 无法定位热点函数，dlv 调试基本失效。
- 仅在发布版中启用，开发/测试阶段禁用
- 若需部分保留调试信息，可只用
-w（去 DWARF 但留符号），体积缩减略少但堆栈仍可用 - 注意 macOS 上
-s可能导致某些 cgo 调用异常，如有 CGO_ENABLED=1，先验证 - 实测命令：
go build -ldflags="-s -w -X main.Version=v1.2.0"
交叉编译 + -ldflags 时，时间戳注入容易出错
想在构建时自动写入当前时间，常有人用 $(date) 或 $(git log -1 --format=%cd)，但 shell 展开发生在本地，若在 CI 中跨平台交叉编译（比如 Linux 上编译 Windows 版），时间可能错乱，或因空格、引号导致 -X 参数截断。
- 安全做法是预生成字符串并转义：用
printf '%q' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" - 更稳的是在 Go 代码里读环境变量，构建时传
-X main.BuildTime=$BUILD_TIME，由 CI 设置该变量 - Git 提交哈希建议用
git rev-parse --short HEAD，避免长哈希触发参数长度限制 - 错误示例：
-X main.Time=$(date)—— 没引号、含空格，链接器直接报flag provided but not defined: -X
静态链接与 cgo 开关对体积和部署的影响比 -ldflags 更大
-ldflags 只影响元数据和链接行为，真正决定二进制是否“开箱即用”以及体积下限的，是 cgo 和静态链接设置。默认开启 cgo 会导致依赖系统 libc，无法直接拷贝到 Alpine；而关闭后若没处理好 DNS 或 TLS，又会连不上 HTTPS。
立即学习“go语言免费学习笔记（深入）”；
- 纯静态编译（推荐生产）：
CGO_ENABLED=0 go build -a -ldflags="-s -w" - 若必须用 cgo（如 sqlite、openssl），则加
-extldflags "-static"，但需确保宿主机有静态 libc - Alpine 部署前务必验证：
file yourbinary应显示 “statically linked”，而非 “dynamically linked” - CGO_ENABLED=0 下
net.DefaultResolver会 fallback 到纯 Go DNS 解析，无需额外配置
