配置结构

2023年2月17日 1 分钟阅读配置文档

赞助

成为我们的资助者或赞助商，以支持我们的工作。

本页内容

赞助商

本文将尽量简单地介绍 Hugo 的配置结构。

配置格式

虽然 Hugo 支持 TOML、YAML 和 JSON，不过笔者建议使用 TOML 或 YAML，因为 JSON 并不支持注释。

配置名称

自 Hugo 0.110.0 版本后，Hugo 将优先使用 hugo.* 配置文件，尽管 config.* 仍起作用，不过笔者建议使用 hugo.* 作为配置名称，以与其他项目的配置区分开来。

单配置文件

单配置文件是指在项目根目录下的 hugo.*。

Hugo 也可以通过 --config 参数指定多个配置文件：hugo --config a.toml,b.toml,c.toml。

配置目录

虽然单配置文件简单便捷，但缺点也很明显，一旦配置过多，就难以阅读，在多环境、多语言的情况下更为糟糕，而配置目录可以更好地应对这种情况。

 1tree config
 2config
 3├── _default
 4│   ├── hugo.toml
 5│   ├── languages.toml
 6│   ├── menus.en.toml
 7│   ├── menus.zh-hans.toml
 8│   └── params.toml
 9│   └── params.en.toml
10│   └── params.zh-hans.toml
11├── development
12│   ├── hugo.toml
13│   └── params.toml
14├── production
15│   ├── hugo.toml
16│   └── params.toml
17└── staging
18    ├── hugo.toml
19    └── params.toml

如上所示，站点们定义了四种环境：

环境	描述
`_default`	默认配置，会被合并到最终的配置中去。
`development`	开发环境，`hugo server` 默认环境。
`staging`	自定义环境，可以通过 `-e staging` 加载。
`production`	生产环境，`hugo` 默认环境。