模板函数 on Hugo 中文文档

templates.Current

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

（0.146.0 新增）

templates.Current 函数提供内省（introspection）能力，可以用来查看当前正在执行的模板的细节。调试复杂的模板层次、理解渲染过程中的执行流向时，这个能力很有用。

templates.Defer

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

用法

templates.Defer 函数把模板的执行推迟到所有站点与输出格式都渲染完成之后。

templates.Exists

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

模板文件是指项目自身或其任一主题组件 layouts 目录中的任何文件。

把 templates.Exists 函数用于动态模板路径：

{{ $partialPath := printf "headers/%s.html" .Type }}
{{ if templates.Exists ( printf "_partials/%s" $partialPath ) }}
  {{ partial $partialPath . }}
{{ else }}
  {{ partial "headers/default.html" . }}
{{ end }}

在上例中，如果给定内容类型没有对应的 “headers” partial 模板，Hugo 会回退到默认模板。

templates.Inner

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

（0.154.0 新增）

templates.Inner 函数定义块式 partial 模板调用中嵌套代码的注入点。这是创建局部模板装饰器所用的核心机制。

概述

templates.Inner 函数在 partial 模板中充当占位符。当 partial 模板被当作装饰器调用时，它先捕获调用模板中的一段代码，而不是立即渲染。templates.Inner 函数告诉 Hugo 把捕获到的内容注入到哪个确切位置。