# 模板
> 用模板把内容、资源与数据渲染为发布页面，并概述本章主题与阅读顺序。
- 本页规范地址：https://hugozh.cn/templates/
- 最近更新：2026-10-02
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译

## 本章页面
- [404 页面](https://hugozh.cn/templates/404/)：创建 404 模板，为未找到的地址渲染错误页面。（Markdown：https://hugozh.cn/templates/404/index.md）
- [robots.txt](https://hugozh.cn/templates/robots/)：用模板生成自定义 robots.txt，控制搜索引擎的抓取范围。（Markdown：https://hugozh.cn/templates/robots/index.md）
- [站点地图](https://hugozh.cn/templates/sitemap/)：使用内建模板生成 sitemap.xml，并按页面或全站调整配置。（Markdown：https://hugozh.cn/templates/sitemap/index.md）
- [RSS 订阅](https://hugozh.cn/templates/rss/)：控制订阅源的生成范围与条数，或编写自定义 RSS 模板。（Markdown：https://hugozh.cn/templates/rss/index.md）
- [菜单模板](https://hugozh.cn/templates/menu/)：在模板中遍历菜单项，渲染平铺或嵌套的导航结构。（Markdown：https://hugozh.cn/templates/menu/index.md）
- [分页](https://hugozh.cn/templates/pagination/)：把列表页拆分为多个分页，并生成页码导航。（Markdown：https://hugozh.cn/templates/pagination/index.md）
- [内建模板](https://hugozh.cn/templates/embedded/)：Hugo 自带的内建模板清单，以及覆盖它们的通用做法。（Markdown：https://hugozh.cn/templates/embedded/index.md）
- [简介](https://hugozh.cn/templates/introduction/)：介绍 Hugo 的模板语法：上下文、动作、变量、函数与方法。（Markdown：https://hugozh.cn/templates/introduction/index.md）
- [模板查找顺序](https://hugozh.cn/templates/lookup-order/)：Hugo 为给定页面挑选模板的查找规则，以及新版目录约定。（Markdown：https://hugozh.cn/templates/lookup-order/index.md）
- [新版模板系统概览](https://hugozh.cn/templates/new-templatesystem-overview/)：Hugo v0.146.0 重写模板系统后的目录变化、查找顺序与迁移对照。（Markdown：https://hugozh.cn/templates/new-templatesystem-overview/index.md）
- [局部模板装饰器](https://hugozh.cn/templates/partial-decorators/)：用局部模板装饰器编写可复用的包裹式组件，并用 templates.Inner 注入内容。（Markdown：https://hugozh.cn/templates/partial-decorators/index.md）
- [短代码模板](https://hugozh.cn/templates/shortcode/)：创建自定义短代码模板：位置与命名、参数读取、返回值处理与嵌套。（Markdown：https://hugozh.cn/templates/shortcode/index.md）
- [内容类型](https://hugozh.cn/templates/types/)：内容类型的来源与作用：如何决定模板查找、如何复用模板。（Markdown：https://hugozh.cn/templates/types/index.md）

---
## 本章导读

模板（template）决定内容、资源与数据最终以什么样子发布。Hugo 使用 Go 标准库的 `text/template` 与 `html/template` 包，渲染 HTML 时默认用后者，输出天然对代码注入做了防护；你也可以为 CSV、JSON、RSS、纯文本等输出格式编写模板。

模板由**上下文**（context）、动作、变量、函数与方法组成。其中上下文最关键：传入模板的数据就是上下文，在模板里用点（`.`）表示。页面模板收到的是 `Page` 对象，通过它的方法取得标题、日期与自定义参数。新手最常见的模板错误大多与上下文有关，建议先弄清这个概念。

## 阅读顺序建议

1. [简介](/templates/introduction/)：上下文、动作、变量、函数与方法的基本用法，是后面各页的共同基础。
2. [新版模板系统概览](/templates/new-templatesystem-overview/)：`layouts` 目录在 v0.146.0 之后的组织方式与迁移要点。
3. [模板查找顺序](/templates/lookup-order/)：Hugo 如何在页面种类、布局、输出格式与语言之间取舍。
4. [局部模板装饰器](/templates/partial-decorators/)：用 `partial` 组合可复用的包裹式组件。
5. [短代码模板](/templates/shortcode/)：把模板能力带到内容写作中。

刚开始接触 Hugo 的话，建议先完成[快速开始](/getting-started/quick-start/)，对项目目录结构与构建流程有个整体印象，再回到本章。内容写作中常见的短代码调用语法，参见[短代码](/shortcodes/)。