hugo

hugo.GoVersion

返回编译 Hugo 二进制所用的 Go 版本。

签名
hugo.GoVersion
返回类型
string

这一页解决什么问题

排查「同一份模板在两台机器上结果不同」时,除了 Hugo 版本,还要看构建它的编译器版本:Hugo 由 Go 编译而成,Go 版本不同可能影响正则、时间解析、排序等行为。hugo.GoVersion 返回编译当前二进制所用的 Go 版本,通常出现在调试页或 issue 环境信息里。

什么时候用,什么时候别用

该用:

别用:

  • 判断 Hugo 功能是否可用 → 用 hugo.Version 或 hugo.IsExtended:模板作者面向的是 Hugo 版本,不是 Go 版本;
  • 在模板里做「Go 版本 ≥ x」的分支 → 上游未把它设计成功能开关,不同发行版编译时使用的 Go 版本不受你控制。

hugo.GoVersion 是字段值,不是方法:不要写成 hugo.GoVersion "参数"(实测构建失败,见边界表)。

上游给出的示意输出:

go-html-template
{{ hugo.GoVersion }} → go1.21.1

完整示例:输出完整环境信息

layouts/_partials/env-info.htmlgo-html-template
<p>Hugo {{ hugo.Version }}(Go {{ hugo.GoVersion }})</p>

在本机(Hugo 0.167.0 extended,Windows)实测渲染为:

html
<p>Hugo 0.167.0(Go go1.27.1)</p>

你应当看到什么:形如 go1.x.y 的字符串——注意它自带 go 前缀,你的文案里不要重复写「Go go1.27.1」以外的前缀(例如 Go version go1.27.1 之类)。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,Windows,最小站点。

情况 结果 是否报错
{{ hugo.GoVersion }} string,本机为 go1.27.1 否
空值 / nil 不适用:由二进制提供,恒有值 否
传入参数 {{ hugo.GoVersion "x" }} —— 是:GoVersion has arguments but cannot be invoked as function(字段而非方法)
返回类型(printf "%T") string 否

常见坑

类别 症状 真因 怎么修
报错看不懂 GoVersion has arguments but cannot be invoked as function 把它当方法调用 去掉参数,直接写 {{ hugo.GoVersion }}
没报错但结果不对 用 Go 版本判断 Hugo 功能 Go 版本与 Hugo 版本没有一一对应关系 判断功能用 hugo.Version
没报错但结果不对 文案里出现两个 go(如 Go go1.21.1) 返回值本身已带 go 前缀 文案写「Go 版本:go1.27.1」或直接输出原值

更多排查入口见故障排查。