Hugo 模块 on Hugo 中文文档

简介

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

Hugo 用模块（module）作为最基本的组织单位。一个模块既可以是一个完整的 Hugo 项目，也可以是更小的、可复用的片段，用来提供 Hugo 七类组件（component）中的一类或几类：

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

注意：要与模块打交道，必须安装 Git 与 Go 1.18 或更高版本。

模块（module）是 Hugo 的基本组织单位，使用时需要了解几条规则：

要导入模块，先要把项目本身初始化为模块。例如：

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

一个项目可以把主题配置为任意多个主题组件（theme component）的组合：

theme = ["my-shortcodes", "base-theme", "hyde"]

这种组合还可以嵌套：主题组件本身也能在自己的 hugo.toml 中引入其他主题组件，这就是主题继承（theme inheritance）。

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

需要 Node 包（例如为了 Tailwind CSS）的模块，可以在模块根目录用一份标准的 package.json 声明这些依赖。Hugo 会把所有模块的依赖汇总到一个 npm 工作区（npm workspace）中，因此项目层面只需要执行一次 npm install。