《GO标准库》系列文章所涉及代码均在 go1.13.3 版本中验证通过。

编写程序的时候,一个好的惯例是打印出当前的环境配置,构建版本,和运行时版本,尤其是你的程序很复杂的时候,这些信息就显得尤为重要。这有助于在程序遇到异常时分析和定位问题。

除了构建版本之外,日志信息中还需要包括环境变量,Go 编译时的二进制版本。接下来将展示如何在程序信息中包含 Go 运行时版本。

代码展示:

详细说明:

runtime 包中有很多有用的函数。如 Verison 函数就返回了 Go 的运行时版本。文档表明,该函数通常返回提交的 hash 和二进制文件构建的时间,也可能是一个发行标签(如 "go1.13.3")。

实际上,Version 函数返回的是 runtime/internal/sys.TheVersion 常量的值,这个常量在文件 $GOROOT/src/runtime/internal/sys/zversion.go 中定义。

这个 .go文件由 go dist 工具生成,版本信息由 go/src/cmd/dist/build.go 文件中的 findgoversion 函数获得。

findgoversion函数内指明,会优先从 $GOROOT/VERSION 文件中获取 Go 版本信息,如果文件不存在,则使用 $GOROOT/VERSION.cache 文件,如果文件仍不存在,则从 git 仓库信息中获取版本信息,前提是你已经为 Go 代码初始化了 git 仓库。