Hugo 函数 on Hugo 中文文档

hugo.BuildDate

Fri, 02 Oct 2026 00:00:00 +0800

用法

hugo.BuildDate 函数返回 Hugo 二进制的编译日期，格式遵循 RFC 3339。

{{ hugo.BuildDate }} → 2023-11-01T17:57:00Z

hugo.CommitHash

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.CommitHash }} → a4892a07b41b7b3f1f143140ee4ec0a9a5cf3970

hugo.Data

Fri, 02 Oct 2026 00:00:00 +0800

（0.156.0 新增）

用法

用 hugo.Data 函数访问 data 目录中的数据，也可以访问[挂载][]到 data 目录的任何目录中的数据。支持的数据格式包括 JSON、TOML、YAML 与 XML。

hugo.Deps

Fri, 02 Oct 2026 00:00:00 +0800

用法

hugo.Deps 函数返回项目依赖的切片，依赖可以是模块，也可以是本地主题组件。

方法

在 hugo.Deps 返回的每个 hugo.Dependency 对象上使用以下方法。

Owner: （hugo.Dependency）在依赖树中，这是第一个把当前模块声明为依赖的模块（例如 github.com/gohugoio/hugo-mod-bootstrap-scss/v5）。
Path: （string）返回模块路径，或 themes 目录下的路径（例如 github.com/gohugoio/hugo-mod-jslibs-dist/popperjs/v2）。
Replace: （hugo.Dependency）返回替换当前依赖的那个依赖。
Time: （time.Time）返回该版本的创建时间（例如 2022-02-13 15:11:28 +0000 UTC）。
Vendor: （bool）报告该依赖是否被 vendor（内置于项目）。
Version: （string）返回模块版本（例如 v2.21100.20000）。

示例

下面是一个列出依赖的表格示例：

hugo.Environment

Fri, 02 Oct 2026 00:00:00 +0800

用法

hugo.Environment 函数返回当前运行的环境，其取值由 --environment 命令行标志决定。

{{ hugo.Environment }} → production

命令行示例：

命令	环境
`hugo build`	`production`
`hugo build --environment staging`	`staging`
`hugo server`	`development`
`hugo server --environment staging`	`staging`

hugo.Generator

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.Generator }} → <meta name="generator" content="Hugo 0.167.0">

hugo.GoVersion

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.GoVersion }} → go1.21.1

hugo.IsDevelopment

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.IsDevelopment }} → true/false

hugo.IsExtended

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.IsExtended }} → true/false

hugo.IsMultihost

Fri, 02 Oct 2026 00:00:00 +0800

用法

项目配置：

defaultContentLanguage = 'de'
defaultContentLanguageInSubdir = true
[languages]
  [languages.de]
    baseURL = 'https://de.example.org/'
    label = 'Deutsch'
    locale = 'de-DE'
    title = 'Projekt Dokumentation'
    weight = 1
  [languages.en]
    baseURL = 'https://en.example.org/'
    label = 'English'
    locale = 'en-US'
    title = 'Project Documentation'
    weight = 2

模板：

{{ hugo.IsMultihost }} → true

hugo.IsMultilingual

Fri, 02 Oct 2026 00:00:00 +0800

用法

项目配置：

defaultContentLanguage = 'de'
defaultContentLanguageInSubdir = true
[languages]
  [languages.de]
    label = 'Deutsch'
    locale = 'de-DE'
    title = 'Projekt Dokumentation'
    weight = 1
  [languages.en]
    label = 'English'
    locale = 'en-US'
    title = 'Project Documentation'
    weight = 2

模板：

{{ hugo.IsMultilingual }} → true

hugo.IsProduction

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.IsProduction }} → true/false

hugo.IsServer

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.IsServer }} → true/false

hugo.Sites

Fri, 02 Oct 2026 00:00:00 +0800

（0.156.0 新增）

排序

返回的集合按层级排序，后一个维度用于打破前一个维度的并列：

先按语言（Language）的 weight 升序排序；如果 weight 相同或未定义，则退回字典序。
再按版本（Version）的 weight 升序排序；并列时 Hugo 默认按语义化版本降序排列。
最后按角色（Role）的 weight 升序排序；仍并列时用字典序作为最终回退。

用法

使用以下项目配置：

hugo.Store

Fri, 02 Oct 2026 00:00:00 +0800

（0.139.0 新增）

用法

用 hugo.Store 函数创建一个全局作用域的持久数据结构，用于存取与操作键值对。若要创建其它作用域的数据结构，请参见下文的作用域一节。

hugo.Version

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.Version }} → 0.167.0

hugo.WorkingDir

Fri, 02 Oct 2026 00:00:00 +0800

用法

{{ hugo.WorkingDir }} → /home/user/projects/my-hugo-site