模块概览

2023年2月4日 1 分钟阅读模块文档 tidy clean graph

本文介绍了如何安装、卸载、升级、清理和整顿模块。

本页内容

初始化模块和主题§

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

1hugo mod init example.com/user/blog
sh

example.com/user/blog 为模块和主题的模块路径，其通常为仓库的 URL。

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

hugo.toml

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

hugo.yaml

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

hugo.json

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

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

模块的优先级由上至下，我们推荐将新的模块置于顶部，以避免被其他模块覆盖。

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

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

1hugo mod tidy
sh

递归升级所有模块：

1hugo mod get -u ./...
sh

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

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

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

1hugo mod get -u example.com/user/module@v1.0.0
sh

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

1hugo mod tidy
sh

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

1hugo mod clean
sh

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

1hugo mod graph
sh

1hugo mod graph | grep blog
sh