学习步骤参考
目录
先回顾 Hugo 原始规则(很关键)
Hugo 默认行为(_merge = "replace"): 如果你分多个配置文件,比如
config/_default/hugo.tomlconfig/_default/menus.tomlconfig/_default/params.toml
✅ 同目录下不同文件名(hugo /params/menus)本来就会自动合并,不用写 _merge。
❌ 但:同一个配置键,在多个文件里重复定义,默认是「后面整个覆盖前面」,而不是追加。
举个痛点场景: 你在 hugo.toml 已经写了一部分菜单,又单独建 menus.toml 写菜单。 不写 _merge = "deep" → menus.toml 的菜单直接覆盖掉 hugo.toml 里所有原有菜单,而不是追加进去。
这时候就用到了:合并必要的配置
合并配置就是通过特殊字段 _merge,控制:站点配置 和 主题默认配置 如何融合在一起。只写自己需要修改的配置项,不需要把主题一整套默认配置全部复制粘贴到自己的 hugo.toml,简化配置文件,升级主题也不容易出问题。