# 内容区块
> 用 section 组织内容，控制 URL、列表模板与排序。
- 官方英文原文：https://gohugo.io/content-management/sections/
- 本页规范地址：https://hugozh.cn/content-management/sections/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
## 概述

section（内容区块）是组织内容的一种方式。Hugo 假定用于组织源内容的结构同样用于组织渲染后的站点，`content/` 目录下的一级目录就是顶层 section，目录名既是 section 名，也直接成为 URL 的一段。Hugo 依据内容所在的位置推断它属于哪个 section，不能在前置元数据（front matter）中指定或覆盖。

```tree
content/
├── articles/             <-- section（顶层目录）
│   ├── 2022/
│   │   ├── article-1/
│   │   │   ├── cover.jpg
│   │   │   └── index.md
│   │   └── article-2.md
│   └── 2023/
│       ├── article-3.md
│       └── article-4.md
├── products/             <-- section（顶层目录）
│   ├── product-1/        <-- section（目录中有 _index.md）
│   │   ├── benefits/     <-- section（目录中有 _index.md）
│   │   │   ├── _index.md
│   │   │   └── benefit-1.md
│   │   ├── features/     <-- section（目录中有 _index.md）
│   │   │   ├── _index.md
│   │   │   └── feature-1.md
│   │   └── _index.md
│   └── product-2/        <-- section（目录中有 _index.md）
│       └── _index.md
├── _index.md
└── about.md
```

上例有两个顶层 section：`articles` 与 `products`。`articles` 下的目录都不是 section，而 `products` 下的目录都是 section。section 内部的 section 称为嵌套 section 或子 section。

## section 与非 section 的区别

| 行为 | section | 非 section |
| --- | --- | --- |
| 目录名成为 URL 的一段 | 是 | 是 |
| 有逻辑上的祖先与后代 | 是 | 否 |
| 有列表页 | 是 | 否 |

以上例的文件结构为例：

1. `articles` section 的列表页包含全部文章，不受目录结构影响，因为它的子目录都不是 section。
2. `articles/2022` 与 `articles/2023` 目录没有列表页，它们不是 section。
3. `products` section 的列表页默认包含 `product-1` 与 `product-2`，但不包含它们的后代页面。要包含后代页面，请在 section 模板中用 `RegularPagesRecursive` 方法代替 `Pages` 方法。
4. `products` section 中的所有目录都有列表页，每个目录都是 section。

## 模板选择

Hugo 有一套明确的模板查找顺序来决定用哪个模板渲染页面，查找规则只考虑顶层 section 名，选择模板时不考虑子 section 名。以上例的文件结构为例，section 模板对应关系如下：

| 内容目录 | section 模板 |
| --- | --- |
| `content/products` | `layouts/products/section.html` |
| `content/products/product-1` | `layouts/products/section.html` |
| `content/products/product-1/benefits` | `layouts/products/section.html` |

单页模板同理：

| 内容目录 | 单页模板 |
| --- | --- |
| `content/products` | `layouts/products/page.html` |
| `content/products/product-1` | `layouts/products/page.html` |
| `content/products/product-1/benefits` | `layouts/products/page.html` |

需要为某个子 section 使用不同模板时，在前置元数据中指定 `type` 或 `layout`。`type` 可以覆盖由页面所在顶层 section 推导出的内容类型，`layout` 则直接指定模板名，见[内容类型](/templates/types/)。

## 祖先与后代

一个 section 有一个或多个祖先（包括首页），以及零个或多个后代。对于：

```text
content/products/product-1/benefits/benefit-1.md
```

内容文件 `benefit-1.md` 有四个祖先：`benefits`、`product-1`、`products` 和首页。这种逻辑关系让我们可以用 `Parent` 与 `Ancestors` 方法遍历站点结构，例如用 `Ancestors` 渲染面包屑导航：

```go-html-template
<nav aria-label="breadcrumb" class="breadcrumb">
  <ol>
    {{ range .Ancestors.Reverse }}
      <li>
        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
      </li>
    {{ end }}
    <li class="active">
      <a aria-current="page" href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
    </li>
  </ol>
</nav>
```

配合下面的 CSS：

```css
.breadcrumb ol {
  padding-left: 0;
}

.breadcrumb li {
  display: inline;
}

.breadcrumb li:not(:last-child)::after {
  content: "»";
}
```

渲染结果中每个面包屑都指向对应页面：

```text
Home » Products » Product 1 » Benefits » Benefit 1
```

## 索引页与 URL 结构

`_index.md` 在 Hugo 中有特殊作用，它让你可以为 `home`、`section`、`taxonomy`、`term` 页面添加前置元数据与正文。站点首页以及每个内容 section、分类法和术语都可以各有一个 `_index.md`；用 `Site` 或 `Page` 对象的 `GetPage` 方法可以访问其中的内容与元数据。

以典型的 section 列表页为例，文件与 URL 各部分的对应关系如下：

```text
content/posts/_index.md
```

构建后输出到下面的位置：

```text
https://example.org/posts/index.html
```

其中 URL 是 `/posts/`，section 是 `posts`。section 可以嵌套任意深度，关键是要让整棵 section 树都可导航，最下层的 section 至少要包含一个内容文件（即 `_index.md`）。带 `_index.md` 的目录就是[分支包](/content-management/page-bundles/)，首页包内不能包含其他内容页面，但允许放图片等其他文件。

section 中的单个内容文件由单页模板渲染：

```text
content/posts/my-first-hugo-post.md
```

构建后输出到：

```text
https://example.org/posts/my-first-hugo-post/index.html
```

其中 URL 是 `/posts/my-first-hugo-post/`，section 是 `posts`，slug 是 `my-first-hugo-post`。这里的地址假定使用了 Hugo 默认的漂亮 URL 形式，并且项目配置中 `baseURL = "https://example.org/"`。

## 路径的组成

理解下列概念有助于掌握内容组织方式与默认构建行为之间的关系：

section
: 默认内容类型由内容所处的 section 决定，section 则由内容在项目 `content` 目录中的位置决定，不能在前置元数据中指定或覆盖。

slug
: slug 是 URL 路径的最后一段，由页面逻辑路径的最后一段确定，也可以用前置元数据中的 `slug` 覆盖，详见 [URL 管理](/content-management/urls/)。

path
: 内容的 path 由文件所在的 section 路径决定，它基于内容所在位置的路径，并且不包含 slug。

url
: url 是完整的 URL 路径，由文件路径决定，也可以用前置元数据中的 `url` 覆盖，详见 [URL 管理](/content-management/urls/)。

## 延伸阅读

- [目录结构](/getting-started/directory-structure/)
- [前置元数据](/content-management/front-matter/)
- [页面包](/content-management/page-bundles/)
- [内容类型](/templates/types/)