用 go:build + 编译期常量 + 运行时检查比 runtime.Version() 更可靠；版本过期应日志预警并可配置退出，而非硬拦启动。
直接结论：用 go:build + 编译期常量 + 运行时检查，比 runtime.Version() 或读文件更可靠；版本过期不是“拦住启动”，而是“日志预警 + 可配置退出”。
为什么不能只靠 runtime.Version()
这个函数返回的是 Go 编译器版本（如 go1.25.0），不是你模块自己的版本。你想预警的是 yangzhenyu.com/go-yzy v1.2.0 已过期，和 Go 语言版本无关。硬塞 runtime.Version() 会导致误报或完全失效。
怎么把模块版本编译进二进制
Go 没有内置的“自动注入版本号”机制，必须手动传参。推荐在构建时用 -ldflags 注入：
go build -ldflags="-X 'main.version=v1.3.0' -X 'main.buildTime=20260804T215800Z'" ./cmd/server-
main.version必须是包级变量，且类型为string；不能是 const，否则-X无效 - 变量声明要放在
main包里（比如main.go开头）：var version string - 如果用
go run测试，它不走完整构建流程，version会是空字符串——这是正常现象，上线二进制才有效
运行时怎么判断是否过期
过期逻辑不能写死在代码里（比如 if version == "v1.2.0" { panic(...) }），而应从外部控制。推荐做法：
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
- 定义一个过期列表，存于独立配置文件（如
deprecated_versions.json），内容类似：{"v1.2.0": "2026-07-01", "v1.1.0": "2026-05-15"} - 启动时读该文件（注意路径：建议放
./etc/或通过os.Getenv("CONFIG_DIR")指定） - 用
time.Parse("2006-01-02", ...)解析过期日期，和time.Now()比较 - 若当前版本在列表中且已过期，打 WARNING 日志，并根据环境变量（如
STRICT_VERSION_CHECK=1）决定是否os.Exit(1) - 不要用
panic—— 它会绕过 defer 和日志 flush，导致告警丢失
容易被忽略的坑：跨包版本变量不可见
如果你把 version 变量定义在 internal/version 包里，再用 -X internal/version.version=... 注入，会失败。Go 的 -X 只支持注入 main 包或导出（首字母大写）的变量。所以要么：
- 坚持用
main.version，然后在init()里复制到其他包的公开变量（如version.Version） - 或者干脆放弃注入，改用构建脚本生成一个
version/version.go文件（含const Version = "v1.3.0"），再go generate触发 - 别试图在
go.mod里解析版本——go list -m是命令行工具，运行时不可用
真正麻烦的不是注入版本，而是让运维能快速感知并响应过期。日志里只写 “v1.2.0 已过期” 不够，得附上升级指引链接、当前支持的最新版、以及 STRICT_VERSION_CHECK 的开关说明——这些都得在预警逻辑里一并输出，而不是等出问题了再翻文档。
