配置 on Hugo 中文文档

配置简介

Thu, 01 Oct 2026 00:00:00 +0800

常规设置与配置分区

项目配置中的每个顶层键要么是常规设置，要么是配置分区。

常规设置是单个值，例如 baseURL 或 title。配置分区则把相关的嵌套设置归为一组，例如 markup、menus 或 params。

全部设置

Thu, 01 Oct 2026 00:00:00 +0800

本页是 Hugo 顶层配置键的索引，不是教程：它把项目配置中的每一个顶层键按名称字母序列出，并标注类型、默认值与一句话说明。请注意，这里的默认值只是上游文档在当前版本下的标注，精确默认值会随 Hugo 版本变化，请用 hugo config 或 hugo config mounts 核对你自己项目中实际生效的值。

构建配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置

[build] 分区用于控制全局构建行为，默认配置如下：

[build]
noJSConfigInAssets = false
useResourceCacheWhen = 'fallback'

[build.buildStats]
enable = false
disableIDs = false
disableTags = false
disableClasses = false

[build.cleanDestinationDir]
enable = false
keepDirs = ['{**/,}.*']
keepFiles = ['{**/,}.{git,gitignore,gitattributes}']

[[build.cacheBusters]]
source = '(postcss|tailwind)\.config\.(js|mjs|cjs)'
target = '(css|styles|scss|sass)'

顶层设置

键名	类型	默认值	说明
`buildStats`	`map`	见下文	构建统计，详见构建统计一节。
`cacheBusters`	`[]map`	见下文	缓存失效规则，详见缓存失效一节。
`cleanDestinationDir`	`map`	见下文	目标目录清理，详见清理目标目录一节。
`noJSConfigInAssets`	`bool`	`false`	是否禁止在 `assets` 目录下写出记录 `js.Build` 导入映射的 `jsconfig.json`。该文件用于在 VS Code 等代码编辑器中提供智能提示与跳转；如果你没有使用 `js.Build`，则不会写出该文件。
`useResourceCacheWhen`	`string`	`fallback`	何时使用资源文件缓存，取值为 `never`、`fallback` 或 `always` 之一。适用于把 Sass 转译为 CSS 的场景。

构建统计

[build.buildStats]
enable = false
disableIDs = false
disableTags = false
disableClasses = false

键名	类型	默认值	说明
`enable`	`bool`	`false`	是否在项目根目录生成 `hugo_stats.json` 文件。该文件包含已发布站点中每个 HTML 元素的 `class` 属性、`id` 属性与标签名的数组，可作为数据源用于移除未使用的 CSS。这一过程也称为修剪、清除或摇树。
`disableIDs`	`bool`	`false`	是否排除 `id` 属性。
`disableTags`	`bool`	`false`	是否排除元素标签名。
`disableClasses`	`bool`	`false`	是否排除 `class` 属性。

由于 CSS 清除通常只在生产构建时进行，建议把 buildStats 对象放在 config/production 目录下。

缓存配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置

[caches]
  [caches.assets]
    dir = ':resourceDir/_gen'
    maxAge = -1
  [caches.getresource]
    dir = ':cacheDir/:project'
    maxAge = -1
  [caches.images]
    dir = ':resourceDir/_gen'
    maxAge = -1
  [caches.misc]
    dir = ':cacheDir/:project'
    maxAge = -1
  [caches.modulegitinfo]
    dir = ':cacheDir/modules'
    maxAge = '24h'
  [caches.modulequeries]
    dir = ':cacheDir/modules'
    maxAge = '24h'
  [caches.modules]
    dir = ':cacheDir/modules'
    maxAge = -1

用途

Hugo 用文件缓存把数据保存在磁盘上，既避免同一次构建中重复执行相同操作，也让数据可以跨构建持续保留。

级联配置

Thu, 01 Oct 2026 00:00:00 +0800

概述

级联（cascade）会把页面参数和其他前置元数据向下传递给一组页面。默认配置为：

cascade = []

在站点配置中，cascade 是切片类型的键，因此必须写出分区名。例如，把 color 页面参数级联到所有页面：

内容类型配置

Thu, 01 Oct 2026 00:00:00 +0800

支持的内容格式

Hugo 0.144.0 及更高版本支持六种内容格式：

内容格式	媒体类型	标识符	文件扩展名
Markdown	`text/markdown`	`markdown`	`markdown`、`md`、`mdown`
HTML	`text/html`	`html`	`htm`、`html`
Emacs Org Mode	`text/org`	`org`	`org`
AsciiDoc	`text/asciidoc`	`asciidoc`	`ad`、`adoc`、`asciidoc`
Pandoc	`text/pandoc`	`pandoc`	`pandoc`、`pdc`
reStructuredText	`text/rst`	`rst`	`rst`

这些格式既可以作为页面内容，也可以作为页面资源。作为页面资源时，它们的资源类型是 page。

部署目标配置

Thu, 01 Oct 2026 00:00:00 +0800

该配置只在运行 hugo deploy 时生效，详见使用 hugo deploy 部署。

顶层设置

这些设置控制部署过程的整体行为，默认配置如下：

[deployment]
confirm = false
dryRun = false
force = false
invalidateCDN = true
maxDeletes = 256
order = []
target = ''
targets = []
matchers = []
workers = 10

键名	类型	默认值	说明
`confirm`	`bool`	`false`	部署前是否提示确认。
`dryRun`	`bool`	`false`	是否只模拟部署而不对远端做任何改动。
`force`	`bool`	`false`	是否重新上传所有文件。
`invalidateCDN`	`bool`	`true`	是否使部署目标中列出的 CDN 缓存失效。
`maxDeletes`	`int`	`256`	最多删除的文件数，设为 `-1` 表示不限制。
`matchers`	`[]Matcher`	`[]`	匹配器切片，详见匹配器一节。
`order`	`[]string`	`[]`	由正则表达式组成的有序切片，决定上传优先级（从左到右）。不匹配任何表达式的文件最后以任意顺序上传。
`target`	`string`	`''`	目标部署对象的 `name`，默认为第一个目标。
`targets`	`[]Target`	`[]`	部署目标切片，详见目标一节。
`workers`	`int`	`10`	上传文件时使用的并发工作进程数。

目标

一个目标（target）代表一个部署目的地，例如「staging」或「production」。

前置元数据配置

Thu, 01 Oct 2026 00:00:00 +0800

日期

Page 对象上有四个返回日期的方法：

方法	说明
`Date`	返回给定页面的日期。
`ExpiryDate`	返回给定页面的过期日期。
`Lastmod`	返回给定页面的最后修改日期。
`PublishDate`	返回给定页面的发布日期。

Hugo 依据下面这份默认配置决定各方法返回什么值：

HTTP 缓存配置

Thu, 01 Oct 2026 00:00:00 +0800

仅在通过 resources.GetRemote 函数获取远程资源时，这份配置才有意义。

分层缓存

Hugo 使用分层缓存系统：

 .-----------.
|  dynacache  |
'-----+-----'
       |
       v
 .----------.
| HTTP cache |
'-----+----'
       |
       v
 .----------.
| file cache |
'-----+----'

Dynacache: 采用最近最少使用（LRU）淘汰策略的内存缓存。当内容发生变化、命中缓存清除（cache-busting）模式，或内存紧张时，条目会被移出缓存。
HTTP 缓存: 按 RFC 9111 规范为远程资源提供 HTTP 缓存。当资源带有合适的 HTTP 缓存标头时性能最佳。HTTP 缓存借助文件缓存来存储与读取已缓存的资源。
文件缓存: 参见缓存配置。

HTTP 缓存包含两个关键方面：决定缓存哪些内容（缓存过程本身），以及定义多久检查一次更新（轮询策略）。

图像处理配置

Thu, 01 Oct 2026 00:00:00 +0800

处理图像时的默认设置如下：

[imaging]
anchor = 'smart'
bgColor = '#ffffff'
resampleFilter = 'box'

[imaging.avif]
compression = 'lossy'
encoderSpeed = 10
hint = 'photo'
quality = 60

[imaging.jpeg]
quality = 75

[imaging.webp]
compression = 'lossy'
hint = 'photo'
method = 2
quality = 75
useSharpYuv = false

[imaging.exif]
disableDate = false
disableLatLong = false
excludeFields = 'GPS|Exif|Exposure[M|P|B]|Contrast|Resolution|Sharp|JPEG|Metering|Sensing|Saturation|ColorSpace|Flash|WhiteBalance'
includeFields = ''

[imaging.meta]
sources = ['exif', 'iptc']
fields = ['! *{GPS,Exif,Exposure[MPB],Contrast,Resolution,Sharp,JPEG,Metering,Sensing,Saturation,ColorSpace,Flash,WhiteBalance}*']

顶层设置

以下设置对所有图像格式生效。

键名	类型	默认值	说明
`anchor`	`string`	`smart`	裁剪或填充图像时的焦点位置。大小写不敏感，可选 `TopLeft`、`Top`、`TopRight`、`Left`、`Center`、`Right`、`BottomLeft`、`Bottom`、`BottomRight` 或 `Smart`。`Smart` 使用 `muesli/smartcrop` 包找出图像中最有趣的区域。
`bgColor`	`string`	`#ffffff`	把透明图像转换为不支持透明的格式（例如 PNG 转 JPEG）时使用的背景色。当把图像旋转非正交角度、且该区域不透明且处理规格中未指定背景色时，也用该颜色填充产生的空白区域。取值必须为 RGB 十六进制颜色。
`compression`	`string`	—	（自 v0.163.0 起弃用）请改用格式专属的 `compression` 设置，适用于 AVIF 与 WebP 图像。
`hint`	`string`	—	（自 v0.163.0 起弃用）请改用格式专属的 `hint` 设置，适用于 AVIF 与 WebP 图像。
`quality`	`int`	—	（自 v0.163.0 起弃用）请改用格式专属的 `quality` 设置，适用于 AVIF、JPEG 与 WebP 图像。
`resampleFilter`	`string`	`box`	缩放、适配或填充图像时计算新像素所用的算法。大小写不敏感，常用取值包括 `box`、`lanczos`、`catmullRom`、`mitchellNetravali`、`linear`、`nearestNeighbor`。

各重采样滤波器的特点：

语言配置

Thu, 01 Oct 2026 00:00:00 +0800

基础设置

先配置以下基础设置：

defaultContentLanguage = 'en'
defaultContentLanguageInSubdir = false
disableDefaultLanguageRedirect = false
disableLanguages = []

键名	类型	默认值	说明
`defaultContentLanguage`	`string`	`en`	项目的默认语言，需符合 RFC 5646 描述的语法。定义了一个或多个语言时，该值必须与某个已定义的语言键一致。
`defaultContentLanguageInSubdir`	`bool`	`false`	是否把默认内容语言发布到与 `defaultContentLanguage` 同名的子目录中。
`disableDefaultLanguageRedirect`	`bool`	`false`	（自 v0.140.0 起）是否禁用为默认内容语言生成别名重定向。当 `defaultContentLanguageInSubdir` 为 `true` 时，该设置阻止根目录重定向到语言子目录；反之，当它为 `false` 时，该设置阻止语言子目录重定向到根目录。此设置已被更通用的 `disableDefaultSiteRedirect` 取代。
`disableLanguages`	`[]string`	空	在构建过程中要禁用的语言键切片。虽然可用，但更推荐使用每个语言下的 `disabled` 键。

各语言设置

在 languages 键下逐个配置语言：

Markup 配置

Thu, 01 Oct 2026 00:00:00 +0800

默认处理器

在默认配置下，Hugo 使用 Goldmark 把 Markdown 渲染为 HTML：

[markup]
defaultMarkdownHandler = 'goldmark'

以 .md、.mdown 或 .markdown 结尾的文件都会按 Markdown 处理，除非你在前置元数据中用 markup 字段显式指定了其他格式。

要改用其他渲染器处理 Markdown 文件，可在项目配置中把 defaultMarkdownHandler 设为 asciidocext、org、pandoc 或 rst 之一：

媒体类型配置

Thu, 01 Oct 2026 00:00:00 +0800

媒体类型（media type，旧称 MIME 类型）是标识文件格式的两段式名称，例如 HTML 内容的媒体类型是 text/html。在 Hugo 中，已配置的媒体类型有多种用途，其中之一是定义输出格式。下文给出 mediaTypes 区段的键名与默认值，并说明如何修改、新建媒体类型，以及如何注册没有后缀的媒体类型。

菜单配置

Thu, 01 Oct 2026 00:00:00 +0800

定义菜单项有三种方式：自动生成、在页面前置元数据中定义，以及在项目配置中定义。本页介绍项目配置方式，菜单系统的整体说明见内容管理中的菜单。

示例

在项目配置中为 main 菜单定义菜单项：

压缩配置

Thu, 01 Oct 2026 00:00:00 +0800

[minify] 用于在发布阶段压缩输出资源。默认配置如下：

[minify]
disableCSS = false
disableHTML = false
disableJS = false
disableJSON = false
disableSVG = false
disableXML = false
minifyOutput = false

内容类型开关

键名	类型	默认值	说明
`disableCSS`	`bool`	`false`	是否禁用 CSS 压缩。
`disableHTML`	`bool`	`false`	是否禁用 HTML 压缩。
`disableJS`	`bool`	`false`	是否禁用 JavaScript 压缩。
`disableJSON`	`bool`	`false`	是否禁用 JSON 压缩。
`disableSVG`	`bool`	`false`	是否禁用 SVG 压缩。
`disableXML`	`bool`	`false`	是否禁用 XML 压缩，例如 RSS 输出。
`minifyOutput`	`bool`	`false`	是否在渲染时直接压缩输出，而不是在写入文件时压缩。

所有这些开关默认都是 false，即各类资源的压缩默认开启，只有把对应开关设为 true 才会跳过该类型。

模块配置

Thu, 01 Oct 2026 00:00:00 +0800

Hugo 模块是项目、主题与组件的组合单元，通过 [module] 配置。默认配置如下：

[module]
noProxy = 'none'
noVendor = ''
private = '*.*'
proxy = 'direct'
vendorClosest = false
workspace = 'off'

顶层设置

键名	类型	默认值	说明
`auth`	`string`	`''`	自 v0.144.0 起可用。配置执行模块操作时 Go 命令的 `GOAUTH`，是以分号分隔的认证命令列表，用于 go-import 与 HTTPS 模块镜像交互，对私有仓库很有用。详见 `go help goauth`。
`noProxy`	`string`	`'none'`	以逗号分隔的 Glob 模式列表，匹配的路径不使用所配置的代理服务器。
`noVendor`	`string`	`''`	一个 Glob 模式，匹配在 vendor 时应当跳过的模块路径。
`private`	`string`	`'.'`	以逗号分隔的 Glob 模式列表，匹配应被视为私有的路径。
`proxy`	`string`	`'direct'`	下载远程模块所用的代理服务器。默认 `direct`，表示直接使用 `git clone` 之类的操作。
`replacements`	`string`	—	主要用于本地模块开发，是以逗号分隔的「模块路径 → 目录」映射。路径可以是绝对路径，也可以是相对于 `themesDir` 的路径。
`vendorClosest`	`bool`	`false`	是否选择离使用方最近的已 vendor 模块；默认行为是选择第一个。注意同一模块路径只能有一个依赖，一旦启用便无法重新定义。
`workspace`	`string`	`'off'`	要使用的 Go 工作区文件，可为绝对路径或相对于当前工作目录的路径。启用后进入 Go 工作区模式，需要 Go 1.18 或更高版本。

replacements 的写法：

输出格式配置

Thu, 01 Oct 2026 00:00:00 +0800

同一个页面可以输出任意多种格式。你可以定义任意数量的输出格式，只要每种格式最终解析到唯一的文件系统路径即可。默认配置的表格形式如下：

键名	mediaType	weight	baseName	isHTML	isPlainText	noUgly	notAlternative	path	permalinkable	protocol	rel	root	ugly
`html`	`text/html`	10	`index`	`true`	`false`	`false`	`false`	`''`	`true`	`''`	`canonical`	`false`	`false`
`rss`	`application/rss+xml`	0	`index`	`false`	`false`	`true`	`false`	`''`	`false`	`''`	`alternate`	`false`	`false`
`json`	`application/json`	0	`index`	`false`	`true`	`false`	`false`	`''`	`false`	`''`	`alternate`	`false`	`false`
`amp`	`text/html`	0	`index`	`true`	`false`	`false`	`false`	`amp`	`true`	`''`	`amphtml`	`false`	`false`
`calendar`	`text/calendar`	0	`index`	`false`	`true`	`false`	`false`	`''`	`false`	`webcal://`	`alternate`	`false`	`false`
`css`	`text/css`	0	`styles`	`false`	`true`	`false`	`true`	`''`	`false`	`''`	`stylesheet`	`false`	`false`
`csv`	`text/csv`	0	`index`	`false`	`true`	`false`	`false`	`''`	`false`	`''`	`alternate`	`false`	`false`
`markdown`	`text/markdown`	0	`index`	`false`	`true`	`false`	`false`	`''`	`false`	`''`	`alternate`	`false`	`false`
`robots`	`text/plain`	0	`robots`	`false`	`true`	`false`	`false`	`''`	`false`	`''`	`alternate`	`true`	`false`
`sitemap`	`application/xml`	0	`sitemap`	`false`	`false`	`false`	`false`	`''`	`false`	`''`	`sitemap`	`false`	`true`
`sitemapindex`	`application/xml`	0	`sitemap`	`false`	`false`	`false`	`false`	`''`	`false`	`''`	`sitemap`	`true`	`true`
`webappmanifest`	`application/manifest+json`	0	`manifest`	`false`	`true`	`false`	`true`	`''`	`false`	`''`	`manifest`	`false`	`false`

weight、rel、baseName、path 取值为空的项，其含义与上文字段说明中的默认行为一致。下面是与上表对应的部分默认配置片段：

输出配置

Thu, 01 Oct 2026 00:00:00 +0800

输出格式（output format）是定义 Hugo 如何渲染文件的一组设置，html、json、rss 都是内置的输出格式。创建和配置输出格式的完整说明见输出格式配置。

页面配置

Thu, 01 Oct 2026 00:00:00 +0800

Hugo 使用默认排序顺序（default sort order）来确定：在 Page 对象上调用下列方法时，相对于当前页面的「下一篇」和「上一篇」分别是哪一页。

Next 与 Prev
NextInSection 与 PrevInSection

page 区段就是用来配置这里的排序方向的。默认配置如下：

参数配置

Thu, 01 Oct 2026 00:00:00 +0800

用途

params 区段用于存放自定义参数：任何不属于 Hugo 内置配置项的键值对都可以写在 [params] 下。这些参数不会改变 Hugo 的构建行为，只是把数据交给模板使用，因此很适合放置站点副标题、联系方式、第三方服务 ID 一类的内容。

分页配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置

pagination 区段控制列表页面的分页行为。以下为默认值：

[pagination]
disableAliases = false
pagerSize = 10
path = 'page'

设置项

键名	类型	默认值	含义
`disableAliases`	`bool`	`false`	是否禁用第一个分页器的别名生成。
`pagerSize`	`int`	`10`	每个分页器包含的页面数量。
`path`	`string`	`page`	分页 URL 中标识「目标页面是分页器」的那一段。

pagerSize 决定单个分页器容纳多少条内容。首页 /posts/ 显示前 pagerSize 条，第 2 页为 /posts/page/2/，依此类推。若把 path 改为 seite，则第 2 页变为 /posts/seite/2/。

永久链接配置

Thu, 01 Oct 2026 00:00:00 +0800

概述

permalinks 配置用于为页面定义自定义 URL 模式。Hugo 支持两种书写形式：

形式	结构	适用场景
映射形式（map）	按页面类型（page kind）分组的键值对	按顶级区段统一指定模式
数组形式（array）	由若干条 `pattern` 条目组成的数组	需要用页面匹配器精确定位页面子集

隐私配置

Thu, 01 Oct 2026 00:00:00 +0800

责任划分

站点作者有责任确保站点符合所在地区的隐私法规，包括但不限于：

GDPR（通用数据保护条例）：适用于欧盟与欧洲经济区内的个人。
CCPA（加州消费者隐私法案）：适用于加利福尼亚州居民。
CPRA（加州隐私权法案）：在 CCPA 的基础上扩展，提供更强的消费者隐私保护。
CDPA（弗吉尼亚州消费者数据保护法）：适用于收集、处理或出售弗吉尼亚州居民个人数据的企业。

Hugo 的隐私设置可以协助你履行合规义务，但最终责任仍在站点作者。

角色配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置

该特性自 v0.153.0 起可用。

Hugo 默认配置了一个名为 guest、权重为 0 的角色：

[roles.guest]
weight = 0

角色（role）是与语言、版本并列的内容维度之一：同一个逻辑页面可以同时存在多个语言版本、多个版本号以及多个角色的变体。角色在配置文件的 roles 区段中声明，在页面前置元数据的 sites.matrix 中引用。

基础设置

先配置下面两项基础设置：

defaultContentRole = 'guest'
defaultContentRoleInSubdir = false

键名	类型	默认值	说明
`defaultContentRole`	`string`	`guest`	项目的默认角色。当一个或多个角色已被定义时，该值必须与其中一个已定义的角色名匹配。
`defaultContentRoleInSubdir`	`bool`	`false`	是否把默认内容角色发布到与 `defaultContentRole` 同名的子目录中。

默认角色的确定规则是：先取 defaultContentRole 的值；当项目没有定义任何角色时回退到 guest。如果项目定义了一个或多个角色、却没有设置 defaultContentRole，则默认角色是项目中的第一个角色，也就是权重最低的那个；权重相同或都未设置权重时，以字典序作为最终的判定依据。

安全配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置

Hugo 内置的安全策略通过允许列表（allowlist）来配置，用于限制对 os/exec、远程通信等操作的访问。默认情况下访问是受限的：如果某次构建试图使用允许列表中未包含的功能，构建就会失败，并给出详细的错误信息。

片段配置

Thu, 01 Oct 2026 00:00:00 +0800

[segments] 只作用于分段渲染。它控制内容何时被渲染，但并不会限制 Hugo 模板中完整的对象图（站点与页面）的可用性，模板里依然可以访问全部站点与页面。

分段渲染带来几点好处：

服务器配置

Thu, 01 Oct 2026 00:00:00 +0800

这些设置只作用于 Hugo 的开发服务器，因此推荐为开发环境单独建立一个配置目录，把服务器配置放在其中：

project/
└── config/
    ├── _default/
    │   └── hugo.toml
    └── development/
        └── server.toml

配置目录的用法见 /configuration/。

服务配置

Thu, 01 Oct 2026 00:00:00 +0800

Hugo 提供内嵌模板来简化站点与内容的创建，其中一些模板是可配置的。例如，内嵌的 Google Analytics 模板需要一个 Google 跟踪 ID。

[services] 下的键都位于 [services.disqus]、[services.googleAnalytics]、[services.rss]、[services.x] 等子表中。

站点地图配置

Thu, 01 Oct 2026 00:00:00 +0800

以下是站点地图的默认配置值。除非在 front matter 中被覆盖，它们会作用于所有页面。

字段

键名	类型	默认值	说明
`changefreq`	`string`	`""`	页面可能发生变化的频率。有效值为 `always`、`hourly`、`daily`、`weekly`、`monthly`、`yearly`、`never`。使用默认值 `""` 时，Hugo 会从站点地图中省略该字段。
`disable`	`bool`	`false`	是否禁止把页面纳入站点地图。在 front matter 中设为 `true` 可排除该页面。
`filename`	`string`	`sitemap.xml`	生成文件的名称。
`priority`	`float`	`-1`	该页面相对于站点上其他页面的优先级，有效值范围为 0.0 到 1.0。使用默认值 `-1` 时，Hugo 会从站点地图中省略该字段。

changefreq 与 priority 的取值含义参见 sitemaps.org 协议，两者的默认值都表示“不输出该字段”，而不是输出空值。

分类法配置

Thu, 01 Oct 2026 00:00:00 +0800

默认配置定义了两个分类法：categories 与 tags。

默认配置

[taxonomies]
  category = 'categories'
  tag = 'tags'

[taxonomies] 是一个映射：键为分类法的单数形式，值为其复数形式，也就是该分类法在 front matter 中使用的键名。

丑陋 URL 配置

Thu, 01 Oct 2026 00:00:00 +0800

丑陋 URL（ugly URL）是带有文件扩展名的 URL。例如：

https://example.org/section/article.html

在默认配置下，Hugo 生成的是漂亮 URL（pretty URL）。例如：

https://example.org/section/article/

uglyURLs 区段用于改变这一行为，既可以作用于整个站点，也可以只作用于特定区块。

版本配置

Thu, 01 Oct 2026 00:00:00 +0800

注意 versions 配置自 Hugo v0.153.0 起提供。

版本（version）是内容变化的维度之一，与语言（面向本地化）、角色（面向受众）并列。借助版本，你可以用语义化版本同时维护同一内容的不同迭代、发布或生命周期状态，并在一次构建中生成多个版本的站点。

配置 on Hugo 中文文档

配置简介

常规设置与配置分区

全部设置

构建配置

默认配置

顶层设置

构建统计

缓存配置

默认配置

用途

级联配置

概述

内容类型配置

支持的内容格式

部署目标配置

顶层设置

目标

前置元数据配置

日期

HTTP 缓存配置

分层缓存

图像处理配置

顶层设置

语言配置

基础设置

各语言设置

Markup 配置

默认处理器

媒体类型配置

菜单配置

示例

压缩配置

内容类型开关

模块配置

顶层设置

输出格式配置

输出配置

页面配置

参数配置

用途

分页配置

默认配置

设置项

永久链接配置

概述

隐私配置

责任划分

相关内容配置

默认配置

角色配置

默认配置

基础设置

安全配置

默认配置

片段配置

服务器配置

服务配置

站点地图配置

字段

分类法配置

默认配置

丑陋 URL 配置

版本配置