# 学习步骤参考


## 先回顾 Hugo 原始规则（很关键）

Hugo 默认行为（`_merge = "replace"`）： 如果你分多个配置文件，比如

- `config/_default/hugo.toml`
- `config/_default/menus.toml`
- `config/_default/params.toml`

✅ 同目录下**不同文件名**（hugo /params/menus）本来就会自动合并，不用写 `_merge`。

❌ 但：**同一个配置键，在多个文件里重复定义**，默认是「后面整个覆盖前面」，而不是追加。

举个痛点场景： 你在 `hugo.toml` 已经写了一部分菜单，又单独建 `menus.toml` 写菜单。 不写 `_merge = "deep"` → menus.toml 的菜单**直接覆盖掉 hugo.toml 里所有原有菜单**，而不是追加进去。

这时候就用到了：**合并必要的配置**

合并配置就是通过特殊字段 `_merge`，控制：站点配置 和 主题默认配置 如何融合在一起。只写自己需要修改的配置项，不需要把主题一整套默认配置全部复制粘贴到自己的 `hugo.toml`，简化配置文件，升级主题也不容易出问题。

## 


---

> 作者: Anonymous  
> URL: https://www.1mt.run/posts/583bc6c/