模块概览

初始化模块和主题

要使用 Hugo 模块，你需要先初始化你的模块和主题。

1hugo mod init example.com/user/blog

安装模块

在你的站点上安装模块是很简单的，只需于配置中导入相应的模块路径。以 example.com/user/module 为例。

1[module]
2  [[module.imports]]
3    path = 'example.com/user/module'

1module:
2  imports:
3  - path: example.com/user/module

1{
2   "module": {
3      "imports": [
4         {
5            "path": "example.com/user/module"
6         }
7      ]
8   }
9}

安装完模块后，你需要重新启动 Hugo 服务器以完全地加载模块资源。

卸载模块

要卸载模块，你需要从配置文件中删除或注释模块，然后执行 hugo mod tidy。

1[[module.import]]
2# path = "example.com/user/module"

1hugo mod tidy

升级模块

递归升级所有模块：

1hugo mod get -u ./...

更新某个模块可能的最新版本¹：

1hugo mod get -u example.com/user/module

升级到一个特定的版本¹:

1hugo mod get -u example.com/user/[email protected]

整理模块

以下命令从 go.mod 和 go.sum 中移除未使用的模块。

1hugo mod tidy

清理模块缓存

删除当前站点的 Hugo 模块缓存：

1hugo mod clean

打印模块图表

你也许对网站导入的模块和它们的依赖关系感兴趣：

1hugo mod graph

1hugo mod graph | grep blog