Hugo：如何为网站多板块配置独立本地分类法？

一、Content 与 Layouts 文件夹结构 & 本地分类法可行性 #

1. Content 目录结构 #

要实现板块独立标签，需基于Section 级别隔离分类法，目录结构如下：

content/
├── blog/
│   ├── _index.md  # Blog 板块首页配置文件（必填，用于标识这是一个 Section）
│   ├── post-one/
│   │   └── index.md  # Blog 文章1（页面捆绑形式）
│   └── post-two.md   # Blog 文章2（单文件形式）
└── guide/
    ├── _index.md  # Guide 板块首页配置文件（必填）
    ├── guide-one/
    │   └── index.md  # Guide 文章1
    └── guide-two.md   # Guide 文章2

注：tags 目录无需手动创建，Hugo 会根据配置自动生成对应页面

每个文章的 Front Matter 需指定对应板块的标签，例如 Blog 文章：

---
title: "第一篇博客"
tags: ["前端开发", "Hugo 教程"]  # 该标签仅归属 Blog 板块
---

Guide 文章：

---
title: "入门指南"
tags: ["新手教程", "环境搭建"]  # 该标签仅归属 Guide 板块
---

2. Layouts 目录结构 #

需为每个板块单独配置标签页面模板，确保 Hugo 能正确渲染独立的标签列表：

layouts/
├── blog/
│   ├── single.html       # Blog 单篇文章模板
│   ├── list.html         # Blog 文章列表页模板
│   └── tags/
│       ├── list.html     # Blog 标签总列表页（/blog/tags/）
│       └── term.html     # Blog 单个标签的文章列表页（/blog/tags/前端开发）
└── guide/
    ├── single.html       # Guide 单篇文章模板
    ├── list.html         # Guide 文章列表页模板
    └── tags/
        ├── list.html     # Guide 标签总列表页（/guide/tags/）
        └── term.html     # Guide 单个标签的文章列表页（/guide/tags/新手教程）

若想减少重复代码，可将通用模板逻辑放在 layouts/_default/ 目录下，再通过模板继承在板块模板中引用。

3. 页面捆绑能否定义本地分类法？ #

不能。Hugo 的分类法（Taxonomies）仅支持全局或Section 级别，页面捆绑（Page Bundles）无法定义专属的本地分类法，只能通过 Section（即 blog/guide 板块）来实现标签隔离。

二、config.json 配置（解决 404 问题） #

核心是通过 taxonomyScope 配置指定分类法的作用范围，确保 Hugo 为每个板块生成独立标签页面，完整配置示例：

{
  "baseURL": "https://mywebsite.com/",
  "languageCode": "zh-cn",
  "title": "我的网站",
  "taxonomies": {
    "tag": "tags"
  },
  "permalinks": {
    "blog": "/blog/:slug/",
    "guide": "/guide/:slug/"
  },
  "taxonomyScope": {
    "tags": {
      "sections": ["blog", "guide"]
    }
  },
  "outputs": {
    "home": ["HTML"],
    "section": ["HTML"],
    "taxonomy": ["HTML"],
    "term": ["HTML"]
  }
}

关键配置说明 #

1. taxonomies：声明全局分类法，tag 为内部标识，tags 对应 URL 中的路径
2. taxonomyScope：指定 tags 分类法仅作用于 blog 和 guide 两个 Section，实现标签隔离
3. permalinks：定义文章的 URL 结构，确保符合需求
4. outputs：必须包含 taxonomy 和 term 的 HTML 输出，否则 Hugo 不会生成标签页面

常见 404 原因排查 #

• 未配置 taxonomyScope：Hugo 仍生成全局标签页面，而非 Section 级独立页面
• 缺少对应板块的 tags/list.html 或 tags/term.html 模板：Hugo 无法渲染标签页面
• outputs 未包含 taxonomy/term：Hugo 未生成对应的 HTML 文件
• 文章 Front Matter 标签拼写错误，或对应 Section 下无带标签的文章

内容的提问来源于stack exchange，提问作者user1548418