Facebook Hydra嵌套目录结构中配置继承的正确实现方法

问题场景 #

使用Facebook Hydra管理多模型架构（如不同分割任务）的项目配置，主应用通过模型配置中的task键加载对应模型。配置文件树如下：

├── config.yaml
├── data
│   └── default.yaml
├── model
│   ├── task_1
│   │   ├── base.yaml
│   │   ├── variant_1.yaml
│   │   ├── variant_2.yaml
│   └── task_2
│       ├── base.yaml
│       ├── default.yaml
│       ├── variant_1.yaml

默认config.yaml内容：

defaults:
  - data: default
  - model: task_1/base

需求：让variant_1.yaml继承同目录base.yaml的参数（尤其是config超参数字典）并扩展，但之前的尝试出现两种问题：

1. 直接写defaults: [- base]会抛出MissingConfigException: In 'model/task_1/variant_1': Could not load 'model/base'
2. 写defaults: [- task_1/base]会导致base配置被放到独立的task_1键下，而非合并到当前模型配置中。

正确的配置继承方式 #

1. 使用相对路径引用同目录base配置 #

修改model/task_1/variant_1.yaml的内容为：

defaults:
  - ./base

Hydra会将./base解析为当前目录（model/task_1/）下的base.yaml，而非向上查找model/base.yaml。此时执行启动命令：

launch("config", overrides=["model=task_1/variant_1"])

就能正确将base.yaml的参数合并到当前配置中，variant_1.yaml中的config会自动覆盖或扩展base.yaml里的config字典，最终得到预期结构：

{
  ...
  config: {base的参数 + variant_1扩展的参数}
}

2. 避免命名空间污染 #

使用task_1/base作为引用时，Hydra会将task_1识别为一个独立配置组，因此会生成额外的顶层键。而相对路径./base会直接将base的内容合并到当前配置的命名空间，不会产生多余键。

更规范的实现方式 #

1. 为每个task目录添加default.yaml #

在model/task_1/下创建default.yaml，统一管理该task的默认配置：

defaults:
  - ./base
  - _self_

这样当指定model=task_1时，会自动加载base.yaml的配置，同时允许通过override指定具体variant（如model=task_1/variant_1）。

2. 全局默认配置分层 #

在model/目录下创建default.yaml，设置全局默认的task：

defaults:
  - task_1/default

此时主config.yaml中的model配置可简化为：

defaults:
  - data: default
  - model: default

后续切换任务只需通过override修改，如model=task_2即可加载task_2的默认配置。

3. 统一task标识 #

在每个task的base.yaml中添加task字段，如task_1/base.yaml：

task: task_1
config:
  # 基础超参数

主应用可直接通过cfg.model.task获取当前任务类型，无需额外解析配置路径。

内容的提问来源于stack exchange，提问作者Josh