需用 -ldflags 注入版本字符串，再通过 go/version.parse 安全校验；runtime.version() 返回编译器版本而非应用版本，二者不可混淆。
如何在构建时注入 Go 版本信息？
Go 1.22 新增了 go/version 包，但它本身不负责“注入”——它只提供解析和比较能力。真正实现构建时版本注入，仍需靠 ldflags 配合自定义变量，go/version 的作用是让运行时能安全、规范地验证这些字符串。
典型做法是：编译时用 -ldflags "-X main.version=1.22.0" 注入字符串，再在代码里用 go/version.Parse 做校验或比较：
package main
import (
"fmt"
"go/version"
)
var version = "dev" // 默认值，会被 -ldflags 覆盖
func main() {
v, err := version.Parse(version)
if err != nil {
fmt.Printf("invalid version: %v\n", err)
return
}
if v.Compare("1.22.0") >= 0 {
fmt.Println("running on Go 1.22+ ✅")
}
}
-
go/version.Parse比直接字符串比较更健壮，能处理v1.22.0、1.22.0-rc1、1.22.0+incompatible等格式 - 若注入的字符串非法（如
"unknown"），Parse会返回 error，避免静默失败 - 注意：该包不导出常量或全局变量，所有逻辑都得自己调用函数完成
为什么不用 runtime.Version()？
runtime.Version() 返回的是当前运行 Go 程序所用的 编译器版本（如 "go1.22.0"），不是你应用自身的语义化版本。两者完全无关。
- 你发布一个 v2.5.0 的服务，
runtime.Version()仍可能是"go1.22.0" - 想查“我的服务是否 ≥ v2.3.0”，必须依赖注入的
main.version+go/version.Parse - 混淆这两者是线上排查时最常踩的坑：把 Go 工具链升级当成业务版本升级
构建脚本里怎么安全传入版本？
别手写 -ldflags 字符串拼接，容易漏转义、引号错位。推荐用 Makefile 或 shell 函数封装：
build: go build -ldflags="-X 'main.version=$(shell git describe --tags --always --dirty)'" -o myapp ./cmd
- 单引号包裹整个
-X参数，防止 shell 在空格或+处截断 -
git describe输出类似v2.5.0-3-gabc123-dirty，go/version.Parse能正确识别其主版本 - 如果构建环境没 git（如 CI 的 shallow clone），要 fallback 到环境变量，例如
${APP_VERSION:-dev}
兼容性与部署注意事项
go/version 是 Go 1.22+ 新增包，无法在旧版本中 import。如果你的项目还需支持 Go 1.21，不能直接引入该包。
- 方案一：用 build tag 分离逻辑，
//go:build go1.22，旧版走字符串前缀比较 - 方案二：完全放弃
go/version，改用社区轻量库（如github.com/hashicorp/go-version），但会增加依赖 - 关键点：无论选哪种，
ldflags注入本身在 Go 1.11+ 全版本通用，只是解析逻辑需要适配
最容易被忽略的是：注入的版本字符串一旦写死在二进制里，就无法 runtime 修改。调试时如果看到版本没更新，第一反应不该是查代码，而是确认 go build 命令是否真带了 -ldflags，以及 CI 是否缓存了旧构建产物。
