术语表 on Hugo 中文文档

动作

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

动作

参见模板动作。

原型

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

原型

原型（archetype）是创建新内容时使用的模板。

参见：原型

参数

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

参数

参数（argument）是传给函数、方法或短代码的标量、数组、切片、映射或对象。

数组

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

数组

数组（array）是带编号的元素序列。与 Go 的切片数据类型不同，数组的长度固定。数组中的元素可以是标量、切片、映射、页面或其他数组。

参见：Go 语言规范：数组类型

资源管道

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

资源管道

资源管道（asset pipeline）是一种自动化并优化静态资源处理流程的系统，处理的资源包括图片、样式表和 JavaScript 文件。

bool

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

bool

参见布尔值。

布尔值

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

布尔值

布尔值（boolean）是只有两个取值的数据类型，即 true 或 false。

分支包

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

分支包

分支包（branch bundle）是顶层内容目录，或任何包含 _index.md 文件的内容目录。类似现实中的树枝，分支包可以有后代，包括叶子包与其他分支包。分支包还可以包含页面资源，例如图片。

参见：页面包

分支

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

分支

分支（branch）是页面种类为 home、section、taxonomy 或 term 的节点。分支可以有后代。

构建产物

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

构建产物

构建产物（build artifacts）是在构建过程中生成的静态文件。这些资源默认存放在 public 目录中，代表项目最终可以直接部署的输出。

构建

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

构建

构建（build，动词）是为项目生成静态文件的过程，生成的内容包括 HTML、图片、CSS 与 JavaScript。这一过程会渲染模板、转换资源，并解析项目配置中定义的语言、角色与版本矩阵。

包

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

包

参见页面包。

缓存

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

缓存

缓存（cache）是一种软件组件，它存储数据，以便后续对同一数据的请求更快得到结果。

规范输出格式

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

规范输出格式

规范输出格式（canonical output format）是当前页面中 rel 属性在项目配置里被设为 canonical 的那个输出格式（如果存在这样的格式）。如果当前页面只有一种_输出格式_且它是预定义格式，那么无论其 rel 属性是否设为 canonical，Hugo 都会自动把它视为_规范输出格式_。自定义输出格式不受这条规则约束，必须把 rel 显式设为 canonical。

级联

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

级联

级联（cascade）一个值，就是把分支页面或项目配置中的前置元数据值应用到后代页面。如果后代页面已经定义了该字段，或者更近的祖先分支、级联数组中更靠前的元素已经为同一字段设置了值，Hugo 就不会级联该值。可以用页面匹配器把级联限制在部分页面上。

参见：级联配置

链式

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

链式

链式（chain，动词）是用点号连接一个或多个标识符。标识符可以表示方法、对象或字段。例如 .Site.Params.author.name 或 .Date.UTC.Hour。

CI/CD

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

CI/CD

CI/CD 这一术语是持续集成（Continuous Integration）与持续交付（Continuous Delivery）或持续部署（Continuous Deployment）的缩写，具体指哪一个取决于语境。

CJK

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

CJK

CJK 是对中文、日文与韩文三种语言的统称。

CLI

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

CLI

CLI 是命令行界面（command-line interface）的缩写，指以文本方式与计算机程序或操作系统交互的方法。

码点

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

码点

码点（code point）是 Unicode 标准为每个字符分配的唯一编号。例如拉丁大写字母 A 的码点是 U+0041，emoji 🎉 的码点是 U+1F389。

参见：码点（维基百科）

集合

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

集合

集合（collection）是数组、切片或映射。

组件

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

组件

组件（component）是一组相关文件，位于统一文件系统中，用于在构建 Hugo 项目时完成某项特定功能。这些组件分为七类：原型、资源、内容、数据、模板、翻译表与静态文件，既可以定义在项目中，也可以由模块提供。每类组件在统一文件系统中都有专用目录：

组件	统一文件系统中的目录
archetypes	`archetypes`
assets	`assets`
content	`content`
data	`data`
templates	`layouts`
translation tables	`i18n`
static files	`static`

内容适配器

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

内容适配器

内容适配器（content adapter）是一种在构建站点时动态创建页面的模板。例如，可以用它从 JSON、TOML、YAML 或 XML 等远程数据源创建页面。

内容维度

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

内容维度

参见维度。

内容格式

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

内容格式

内容格式（content format）是用于创建内容的标记语言。通常是 Markdown，也可以是 HTML、AsciiDoc、Org、Pandoc 或 reStructuredText。

内容类型

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

内容类型

内容类型（content type）是由顶层目录名推断出的内容分类，也可以在前置元数据中用 type 指定。content 目录根部的页面（包括首页）的内容类型是 “page”。内容类型是模板查找顺序的影响因素之一，也决定创建新内容时使用哪个原型模板。

内容视图

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

内容视图

参见视图模板。

上下文

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

上下文

上下文（context）在模板动作中用点号（.）表示，指的是数据结构中的当前位置。例如，遍历页面集合时，每次迭代中的上下文就是该页面的数据结构。每个模板接收到的上下文取决于模板类型，以及模板被调用的方式。

参见：模板简介

默认语言

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

默认语言

默认语言（default language）是由 defaultContentLanguage 设置定义的值；当项目没有定义任何语言时，回退为 en。当项目定义了一种或多种语言而没有设置该项时，如果存在名为 en 的已启用语言，默认语言就是 en，否则是项目中第一个已启用的语言。第一个语言由最低的权重确定；权重相同或未定义权重时，以字典序作为最终的判定依据。

默认角色

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

默认角色

默认角色（default role）是由 defaultContentRole 设置定义的值；当项目没有定义任何角色时，回退为 guest。当项目定义了一个或多个角色而没有设置该项时，默认角色是项目中的第一个角色，由最低的权重确定；权重相同或未定义权重时，以字典序作为最终的判定依据。

默认站点

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

默认站点

默认站点（default site）是使用默认语言、默认版本与默认角色的那个站点。

默认排序顺序

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

默认排序顺序

页面集合在没有设置其他排序条件时使用的_默认排序顺序_（default sort order）遵循以下优先级：

weight（升序）
date（降序）
linkTitle，缺失时回退到 title（升序）
逻辑路径（升序）

默认版本

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

默认版本

默认版本（default version）是由 defaultContentVersion 设置定义的值；当项目没有定义任何版本时，回退为 v1.0.0。当项目定义了一个或多个版本而没有设置该项时，默认版本是项目中的第一个版本，由最低的权重确定；权重相同或未定义权重时，以语义化版本的降序排序作为最终的判定依据。

依赖图

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

依赖图

依赖图（dependency graph）以图形方式表示 Hugo 项目中所用模块之间的关系，展示模块之间如何相互依赖，形成一张依赖关系网络。

维度

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

维度

维度（dimension）是内容变化的分类轴，使同一个逻辑页面可以同时存在多个变体。三个维度分别是语言、角色与版本。例如，一个逻辑页面可以同时存在于 6 种语言、4 个版本与 2 种角色中。

时长

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

时长

时长（duration）是表示一段时间长度的数据类型，使用的单位包括秒（用 s 表示）、分钟（用 m 表示）与小时（用 h 表示）。例如 42s 表示 42 秒，6m7s 表示 6 分 7 秒，6h7m42s 表示 6 小时 7 分 42 秒。

元素

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

元素

元素（element）是切片或数组的成员。

嵌入式模板

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

嵌入式模板

嵌入式模板（embedded template）是 Hugo 应用程序内置的组件，其中包括局部模板、短代码与渲染钩子等特性，它们为创建网站内容提供预定义的结构或功能。

环境

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

环境

环境（environment）通常是 development、staging、production 三者之一，其行为会因配置与模板逻辑的不同而有差异。例如，生产环境中你可能压缩并给 CSS 加指纹，而在开发环境中这么做通常没有意义。

字段（field）

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

字段（field）是前置元数据（front matter）中预定义的键值对，例如 date 或 title。

标志（flag）

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

标志（flag）是传递给命令行程序的选项，以一个或两个连字符开头。

参见：hugo

float

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

参见floating point。

浮点数（floating point）

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

浮点数（floating point）指带有小数部分的数值数据类型，例如 3.14159。

片段（fragment）

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

片段（fragment）是 URL 的最后一段，以井号（#）开头，用于引用页面中某个 HTML 元素的 id 属性。

前置元数据（front matter）

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

前置元数据（front matter）指每个内容页面开头的元数据，它与正文之间用与格式对应的定界符分隔。

参见：前置元数据

函数（function）

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

函数（function）用在template action中，接收一个或多个arguments并返回一个值。与methods不同，函数不与object关联。

参见：函数

Glob 模式

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

Glob 模式（glob pattern）是一种用于匹配多组值的模式。它是一次性指定多个目标的简写形式，便于处理成组的数据或配置。

参见：Glob 模式

Glob 切片（glob slice）

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

Glob 切片（glob slice）是由glob patterns组成的slice。在切片中，模式前加上一个感叹号（!）和一个空格即可将其取反。取反模式一旦命中，切片中其余模式的求值就会短路，因此适合用于早期的粗粒度排除。

下面的示例演示如何用 Glob 切片在项目配置中定义site matrix：

[sites.matrix]
languages = [ "! no", "**" ]
versions = [ "! v1.2.3", "v1.*.*", "v2.*.*" ]
roles = [ "{member, guest}" ]

上面的 versions 示例求值结果为：(not v1.2.3) AND (v1.*.* OR v2.*.*)。

全局资源（global resource）

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

全局资源（global resource）是 assets 目录中的文件，或是挂载到 assets 目录的任何目录中的文件。

硬链接（hard link）

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

硬链接（hard link）是一种文件系统特性，它允许多个文件名直接指向磁盘上完全相同的数据。与只引用另一个文件路径的快捷方式或符号链接不同，硬链接是底层内容的同等所有者。通过其中一个名字编辑文件，所有名字看到的都会更新；移动或删除其中一个路径，文件仍保持完好，直到所有相关链接都被删除。