泣语

/首页

/文章

/分类

/标签

/系列

/关于

首页/Posts/ Hugo 文章参数使用说明

Hugo 文章参数使用说明

一篇用于说明 title、date、summary、tags、toc 等字段含义和使用方式的示例文档。

WZH

  ·  2 min read

#Hugo研究

这篇文章用来说明 Hugo 文章开头那段 +++ ... +++ 的配置，也就是 front matter，应该怎么写、每个字段是什么意思、哪些字段是常用项。

什么是 front matter #

在 Hugo 里，每篇文章开头都可以放一段元数据，用来描述这篇文章的标题、时间、标签、摘要和页面行为。

例如：

+++
title = 'Hugo 文章参数使用说明'
date = '2026-04-01T17:10:40+08:00'
lastmod = '2026-04-01T17:10:40+08:00'
draft = false
description = '介绍 Hugo 文章 front matter 的常用字段，以及在 Typo 主题中的实际作用。'
summary = '一篇用于说明 title、date、summary、tags、toc 等字段含义和使用方式的示例文档。'
author = 'WZH'
tags = ['Hugo', 'Typo', 'Front Matter']
categories = ['文档']
series = ['博客搭建']
toc = true
readTime = true
autonumber = false
math = false
showTags = true
hideBackToTop = false
hidePagination = false
disableComment = false
+++

这段不是正文，但会影响页面如何渲染和展示。

常用字段说明 #

title #

文章标题，会显示在：

  • 浏览器标题
  • 文章页面主标题
  • 首页和列表页的标题

date #

文章发布时间。Hugo 会用它来排序文章，也会在文章页面显示出来。

lastmod #

文章最后更新时间。如果你后续大改过文章内容，建议同步更新这个字段。

draft #

是否为草稿。

  • true 表示草稿
  • false 表示正式发布

如果文章还是草稿，本地预览时需要这样启动：

hugo server -D

description #

页面描述，主要给搜索引擎和社交分享使用。它通常会进入页面的 meta description。

建议写成一句能准确概括文章内容的话。

summary #

文章摘要，常用于：

  • 首页文章列表
  • 分类页和标签页列表
  • 文章卡片摘要

如果不写，Hugo 有时会自动从正文截取，但自己写通常更稳定。

author #

作者名。如果主题模板启用了作者展示，这个字段会用于文章页显示作者信息。

tags #

标签，适合做细粒度归类。

例如：

tags = ['Hugo', 'Blog', 'Theme']

categories #

分类，通常比标签更粗一些。

例如：

categories = ['建站']

series #

系列字段，适合把多篇相关文章归到一个专题里。

例如：

series = ['博客搭建']

Typo 主题支持的页面行为参数 #

toc #

是否显示文章目录。长文建议开启。

readTime #

是否显示预计阅读时间。

autonumber #

是否自动给标题编号。技术教程或长文更适合开启。

math #

是否启用数学公式渲染。如果文章里没有公式，保持 false 即可。

showTags #

是否在文章页显示标签。

hideBackToTop #

是否隐藏“返回顶部”。

  • false 表示显示
  • true 表示隐藏

hidePagination #

是否隐藏文章底部的上一篇 / 下一篇导航。

disableComment #

是否对当前页面单独关闭评论区。只有你全站启用了评论系统时，这个字段才会有实际作用。

一篇普通文章最少可以写哪些字段 #

如果你想写得简单一点，通常保留下面这些就够了：

+++
title = '文章标题'
date = '2026-04-01T17:10:40+08:00'
draft = false
description = '一句话描述文章内容'
summary = '列表摘要'
tags = ['Hugo']
categories = ['建站']
toc = true
readTime = true
+++

写作建议 #

  • description 用一句话概括文章主旨
  • summary 写成列表页想让读者看到的摘要
  • tags 不要太多，3 到 5 个通常足够
  • categories 保持简洁，1 到 2 个就够
  • 长文开 toc
  • 有大改动时更新 lastmod

新建文章的方式 #

如果你使用：

hugo new content/posts/my-post.md

Hugo 会自动使用 default.md 作为模板，帮你生成一篇带默认 front matter 的新文章。

back to top