Hydra 配置值被覆盖时怎么用 _self_ 检查合成顺序

Hydra 里出现“我在主配置写了值，为什么最后变了”，通常不是字段没有读取，而是 Defaults List 的合成顺序决定了同名值的覆盖关系。先记住结论：默认情况下，主配置会覆盖 Defaults List 中的配置；把 _self_ 放到 Defaults List 开头，则让被选中的配置组覆盖主配置。

官方地址：https://hydra.cc/

排查时按“选了哪些配置”与“同名字段谁最后写入”两层看：先用 --info defaults 看最终 Defaults List，再用 --cfg job 看最终配置值。不要只盯着 config.yaml 文件本身。

先看 defaults 和 _self_ 的覆盖规则

把问题缩小到一个配置组最容易判断。假设 db/mysql.yaml 提供数据库默认值，而主配置还想固定 db.user：

# conf/config.yaml
# _self_ 放在末尾，表示主配置字段在配置组之后合入
defaults:
  - db: mysql
  - _self_

db:
  user: root

# conf/db/mysql.yaml
# 配置组提供一组可复用的数据库默认值
driver: mysql
user: omry
password: secret

此时最终的 db.driver、db.password 来自 db/mysql.yaml，db.user 取 config.yaml 的 root。Hydra 的规则是：多个配置贡献同一个字典时会合并；同名值按照顺序由后者覆盖。

如果把顺序改成下面这样：

# _self_ 放在开头，表示主配置字段先合入
defaults:
  - _self_
  - db: mysql

db:
  user: root

那么 db/mysql.yaml 后合入，db.user 会变成 omry。因此，_self_ 不是普通业务字段，而是“主配置自身在 Defaults List 中位于哪里”的显式标记。省略它时，Hydra 会自动把它追加到列表末尾，也就是主配置默认覆盖配置组。

把同名字段拆成可判断的覆盖表

遇到训练参数或推理参数被覆盖时，不要先改很多 YAML。先列出“字段、来源、期望最终值”三列，通常马上能看出问题属于选择错误还是顺序错误：

这张表还有一个实用边界：只有路径相同的值才会发生覆盖，不同键会合并保留。比如主配置只写 db.user，不会把配置组中的 db.driver 和 db.password 一起抹掉。若整段字典都被换掉，应该继续检查配置组的 package、路径和是否存在其他 Defaults List 项，而不是把所有现象都归因于 _self_。

用 Hydra 诊断信息定位覆盖来源

当文件越来越多，肉眼按 YAML 顺序推断会变得不可靠。Hydra 官方提供了三个互补视图：Defaults Tree 看输入配置树，--info defaults 看展开后的最终 Defaults List，--cfg job 看应用最终拿到的配置对象。

# 先查看配置树，确认嵌套配置组从哪里进入
python train.py --info defaults-tree

# 再查看展开后的最终 Defaults List，确认同一组是否被替换
python train.py --info defaults

# 最后查看任务配置，确认字段的最终值
python train.py --cfg job

如果 --info defaults 里根本没有预期的配置组，问题在 Defaults List 选择或配置搜索路径；如果配置组存在，但 --cfg job 的同名字段值不对，再回到 _self_ 的相对位置和其他同名定义。这个顺序能把“没选中”和“选中了但被覆盖”区分开。

把覆盖规则写进发布前检查

在训练或批量推理任务中，建议把覆盖意图固定下来：主配置负责环境级基线，就把 _self_ 放在末尾；配置组负责强制替换某些字段，就把 _self_ 放在开头。不要一边依赖默认位置，一边在多个嵌套配置里重复写同名键。

# 发布前检查使用同一套入口，避免只看源文件
# --info defaults 关注“选了谁”，--cfg job 关注“最后是多少”
python train.py --info defaults > defaults.txt
python train.py --cfg job > resolved.yaml

最终可以把检查规则压缩成四句话：

• defaults 负责选择配置输入，不等于最终字段值。
• _self_ 负责声明主配置的合成位置。
• 同名值由后合入的配置覆盖，不同键仍会合并。
• 先看 --info defaults，再看 --cfg job，不要凭文件直觉排障。

相关问题

不写 _self_ 会怎样？

Hydra 会把它自动追加到 Defaults List 末尾，因此主配置通常会覆盖配置组中的同名字段。为了让覆盖意图清楚，建议在主配置同时包含业务字段和 Defaults List 时显式写出。

为什么配置组存在但最终值仍然不对？

先看 --info defaults 确认最终列表中是否有其他同名配置，再检查 _self_ 的位置。配置组“被加载”与它的某个字段“最终获胜”是两个不同判断。