Hydra 核心术语全解析从输入配置到输出配置的完整配置体系【免费下载链接】hydraHydra is a framework for elegantly configuring complex applications项目地址: https://gitcode.com/GitHub_Trending/hyd/hydraHydra 是一个用于优雅配置复杂应用的 Python 框架README.md其文档website/docs/advanced/terminology.md集中定义了框架中最常用的一批核心概念。本篇技术指南以该术语文档为骨架结合仓库源码与真实示例系统讲解 Hydra 的配置体系输入配置如何通过配置组、Defaults List 与 Overrides 组合最终产出应用消费的 Output Config。读完本文你将能够准确区分并运用 Config File、Structured Config、Config Group、Config Group Option、Package、Config Search Path 等全部核心概念并理解它们背后的实现机制。术语总览Hydra 的所有配置行为都围绕一条主链路展开Input Configs输入配置→ 经过Defaults List默认列表与Overrides覆盖项的组合composition→ 产出Output Config输出配置交由应用消费。输入配置是构建输出配置的积木Defaults List 说明由哪些积木搭、怎么搭Overrides 是运行时对搭法的临时调整Config Group 与 Package 决定这些积木的组织方式与落点Config Search Path 决定去哪里找积木Plugins 则扩展整个框架的能力边界。下面逐一展开。Input Configs配置的输入形态输入配置Input Configs是用于构建应用所消费的 Output Config 的构建块它们可以通过放入 Config Group 来进行分组。Hydra 中主要有两种输入配置形态Config Files 与 Structured Configs。Config FilesYAML 配置文件Config File 是以 YAML 格式存在的输入配置它们可以存在于文件系统中也可以存在于 Python 模块中例如通过pkg://配置源加载见 Config Search Path。一个最简单的示例配置文件如下术语文档中的原始示例user: name: James Bond age: 7需要注意Hydra 配置文件必须使用.yaml扩展名。这一点在源码层面有硬性约束在 hydra/plugins/config_source.py 的_normalize_file_name方法中.yml扩展名会被直接拒绝并抛出ConfigLoadError(Unsupported config file extension .yml)其他缺少扩展名的文件名会自动补上.yaml。Structured Config带类型信息的配置Structured Config 一词在 Hydra 中有两层含义术语文档用 dataclass 或 attr.s 装饰的类或此类的一个实例并意图将其用作配置根据上述类或对象初始化出的 Config 对象。Structured Config 提供了额外的类型信息从而支持静态与运行时的类型检查。它有两种主要使用模式作为输入配置Input Config使用作为校验 Config File 与命令行参数的 Schema。dataclass class User: name: str age: int从源码角度看Structured Config 通过 hydra/core/config_store.py 中的ConfigStore.store()方法注册进配置仓库。store()接收name配置名、node可以是 DictConfig、ListConfig、Structured Config甚至是 dict 和 list、group配置组子组以/分隔例如hydra/launcher、package配置节点父层级子节点以.分隔例如foo.bar.baz以及provider提供该配置的模块/应用名便于调试。注册后配置通过 ConfigStoreWithProvider 以cs.store(name..., node...)的形式写入仓库并使用OmegaConf.structured(node)完成结构化转换。其他配置Primary Config 与 Output Config术语文档明确区分了两个容易混淆的概念Primary Config主配置在hydra.main()中或在Compose API中指定的输入配置。Output Config输出配置由hydra.main()或 Compose API 基于输入配置与 Overrides 组合compose出的配置。从源码看Compose API 的入口是 hydra/compose.py 中的compose(config_name, overrides, return_hydra_config)函数。它要求GlobalHydra已初始化即必须先使用hydra.main()或调用初始化方法然后调用GlobalHydra.instance().hydra.compose_config(...)完成组合当return_hydra_configFalse默认时会从结果中删除hydra节点后返回。Overrides运行时调整组合过程Overrides 是用于操纵配置组合过程的字符串可以更新、添加、删除配置值以及 Defaults List 选项。它们既可以用在命令行中也可以用在 Compose API 中。在下面的例子中keyvalue就是一个 override$ python my_app.py keyvaluecfg compose(config_name, overrides[keyvalue])在底层hydra/_internal/defaults_list.py 中的Overrides类负责解析所有外部 overriderepo.group_exists()/repo.config_exists()会判断 override 目标是配置组还是普通配置项删除类 override~key进入deletionsgroupvalue形式的追加进入append_group_defaults普通的groupvalue覆盖进入override_choices。如果一条 override 在组合结束后没有被消费ensure_overrides_used()hydra/_internal/defaults_list.py会抛出ConfigCompositionException并贴心提示 Did you mean to override one of ... 或建议用keyvalue追加。Defaults List配置组合的蓝图Defaults List 是输入配置中的一个列表它指示 Hydra 如何组合配置术语文档defaults: - db: mysql # An overridable defaults list entry - schema/school # A non-overridable defaults list entry其中db: mysql是可覆盖的 defaults list 条目overridableschema/school是不可覆盖的 defaults list 条目non-overridable。Defaults List 的组合过程在源码中有完整实现create_defaults_list()hydra/_internal/defaults_list.py会先构造以hydra/config与 primary config 为子节点的VirtualRoot见_create_roothydra/_internal/defaults_list.py再通过_create_defaults_tree_impl递归构建 defaults 树。每个输入的 Defaults List 条目会按逆序处理、最终以深度优先顺序生成扁平的ResultDefault列表_tree_to_listhydra/_internal/defaults_list.py。此外_validate_pathshydra/_internal/defaults_list.py还会校验路径合法性——无论操作系统如何Defaults List 中的路径分隔符只能是/反斜杠\与父路径穿越..都会被拒绝。Config Group配置组Config Group 是 Config Search Path 中包含输入配置的一个目录。Config Group 可以嵌套嵌套时路径元素统一使用正斜杠/分隔与操作系统无关术语文档。例如mi6/agent就是一个嵌套的配置组其下可存放james_bond.yaml等配置选项。Config Group Option配置组选项Config Group Option 是配置组中的一个输入配置。当用于 Defaults List 时一个 Config Group Option 可以是单个输入配置也可以是同一配置组下的输入配置列表术语文档。在源码中单个选项对应 hydra/core/default_element.py 的GroupDefault.is_name()分支而列表选项对应is_options()分支value为list类型。组合时hydra/_internal/defaults_list.py 会将选项列表中的每一项展开为独立的ConfigDefault子树。Package 与 Package Directive配置在输出中的落点Package是配置中一个节点的路径。默认情况下Config Group Option 的 Package 由其所在的 Config Group 推导而来术语文档。例如mi6/agent下的配置默认 Package 就是mi6.agent。Package Directive则用于指定一个 Config File 的根 Package它出现在 YAML 配置文件顶部术语文档详见 overriding_packages.md# package bond.jamesPackage 的推导逻辑在 hydra/core/default_element.py 的_get_final_package中实现默认情况下 package 取相对组路径并把/换成.若父包非空则拼接为父包.子包_global_前缀会被剥离ret[lgi len(_global_) 1:]用于表示全局根语义。Package Directive 的解析在 hydra/plugins/config_source.py 的_get_header_dict中凡是以# 开头的行都会被解析为头部指令headerpackage的值会被记录直到遇到第一个非头部行才停止解析。核心概念实例James Bond 输出配置术语文档用一个完整的 James Bond 示例串起了上述全部概念。三份配置分别如下config.yaml主配置defaults: - mi6/agent: james_bondmi6/agent/james_bond.yaml配置组选项含 Package Directive# package bond.james codename: 007最终组合出的 Output Configbond: james: codename: 007这个例子中每个概念都有明确的对应关系Input Configs输入配置config.yaml与mi6/agent/james_bond.yamlConfig Group配置组mi6/agentConfig Group Option配置组选项james_bondPackages包empty、mi6、mi6.agent、mi6.agent.codename从根到叶子节点的完整路径Package directive包指令# package bond.james将包含它的输入配置的默认 Package 从默认推导值mi6.agent覆盖为bond.james可以看到若没有 Package Directivejames_bond.yaml的内容将默认落在mi6.agent包下而# package bond.james将其重定向到bond.james于是输出配置中出现了bond.james.codename的层级结构。Config Search Path配置搜索路径Config Search Path 是一个按顺序搜索以查找配置的路径列表与 Python 的 PYTHONPATH 类似术语文档详见 search_path.md。搜索规则与 schema 前缀当请求某个配置时搜索路径中第一个匹配的配置被使用。每个搜索路径元素带有一个 schema 前缀如file://或pkg://对应一个ConfigSourcePluginfile://指向文件系统路径可为绝对路径或相对路径相对路径基于当前工作目录解析且所有操作系统上统一使用/作为路径分隔符。pkg://指向一个可导入的 Python 模块以.作为分隔符目录中需要__init__.py文件才会被 Python 视为包。你可以通过--info标志查看搜索路径与 Hydra 实际加载的配置$ python my_app.py --info searchpath从源码看schema 与配置源插件的对应关系定义在 hydra/plugins/config_source.py 的ConfigSource抽象基类中每个实现类必须声明自己的scheme()例如file或pkg并实现load_config()、is_group()、is_config()、available()、list()等接口。仓库内置的实现包括 file_config_source.py 与 importlib_resources_config_source.py 等。修改搜索路径的几种方式使用hydra.main()通过config_path参数指定该路径相对 Python 脚本所在位置。覆盖hydra.searchpath配置可在主配置中定义也可从命令行覆盖。注意hydra.searchpath只能在主配置中配置在其他配置中配置会报错。例如defaults: - dataset: cifar10 hydra: searchpath: - pkg://additional_conf # You can also use file based schema: # - file:///etc/my_app # - file://${oc.env:HOME}/.my_app命令行覆盖方式$ python my_app.py hydra.searchpath[pkg://additional_conf]覆盖命令行--config-dir一种灵活性较低的替代方案详见 hydra-command-line-flags.md。创建SearchPathPlugin框架作者可以在包安装后自动把配置加入搜索路径无需用户操作。可参考 example_searchpath_plugin 示例插件。Plugins插件体系Plugins 扩展 Hydra 的能力。Hydra 拥有多种插件类型例如 Launcher 与 Sweeper术语文档。仓库中维护着多个官方插件覆盖各类启动器与搜索器例如Launcher 类hydra_joblib_launcher、hydra_submitit_launcher、hydra_ray_launcher、hydra_rq_launcherSweeper 类hydra_ax_sweeper、hydra_nevergrad_sweeper、hydra_optuna_sweeper其他hydra_colorlog从源码接口看Launcher 插件继承自 hydra/plugins/launcher.py 的Launcher抽象类需要实现setup()配置启动器实例与launch()接收一批 job 覆盖参数与初始 job 索引返回JobReturn序列。Sweeper 插件继承自 hydra/plugins/sweeper.py 的Sweeper抽象类需要实现setup()与sweep()接收描述扫描行为的参数列表执行扫描并返回所有启动任务的结果。Sweeper.validate_batch_is_legal()还会在启动前预组合每个 batch以尽早发现组合失败。此外 ConfigSource 本身也是一种插件对应file://、pkg://等 schema另有SearchPathPlugin、CompletionPlugin等类型见 hydra/plugins 目录。概念关系速查表下表总结了各核心术语的关键要点便于速查术语含义关键要点Input Config构建 Output Config 的积木分为 Config FileYAML与 Structured Configdataclass/attr.s两种形态Primary Config在hydra.main()或 Compose API 中指定的主输入配置是组合过程的根Output Config组合后的最终配置由 Input Configs Overrides 组合产出Overrides操纵组合过程的字符串可更新/添加/删除配置值与 Defaults List 选项命令行与 Compose API 均可用Defaults List输入配置中的组合蓝图列表条目可覆盖db: mysql或不可覆盖schema/schoolConfig Group搜索路径中包含输入配置的目录可嵌套路径分隔符统一为/Config Group Option配置组中的输入配置可以是单个配置或同组配置列表Package配置中节点的路径默认由 Config Group 推导mi6/agent→mi6.agentPackage Directive指定配置文件根 Package 的头部指令以# package xxx形式写在 YAML 顶部Config Search Path按顺序查找配置的路径列表类似 PYTHONPATH元素带file:///pkg://schema 前缀Plugins扩展 Hydra 能力的模块主要有 Launcher、Sweeper、ConfigSource、SearchPathPlugin 等类型小结Hydra 的术语体系虽多但彼此环环相扣输入配置Config File / Structured Config是素材配置组Config Group / Config Group Option是素材的组织方式Defaults List 是组合蓝图Overrides 是运行时调整Package 决定素材在输出配置树中的落点Config Search Path 决定素材从何处来而 Plugins 则扩展了框架处理这些素材的能力。掌握这套术语后无论是阅读 Hydra 的报错信息、编写自己的配置还是开发插件你都能快速定位到对应机制——文档首页的 术语页 与源码目录 hydra/_internal 与 hydra/core 是继续深入的最佳起点。【免费下载链接】hydraHydra is a framework for elegantly configuring complex applications项目地址: https://gitcode.com/GitHub_Trending/hyd/hydra创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hydra 核心术语全解析：从输入配置到输出配置的完整配置体系
Hydra 核心术语全解析从输入配置到输出配置的完整配置体系【免费下载链接】hydraHydra is a framework for elegantly configuring complex applications项目地址: https://gitcode.com/GitHub_Trending/hyd/hydraHydra 是一个用于优雅配置复杂应用的 Python 框架README.md其文档website/docs/advanced/terminology.md集中定义了框架中最常用的一批核心概念。本篇技术指南以该术语文档为骨架结合仓库源码与真实示例系统讲解 Hydra 的配置体系输入配置如何通过配置组、Defaults List 与 Overrides 组合最终产出应用消费的 Output Config。读完本文你将能够准确区分并运用 Config File、Structured Config、Config Group、Config Group Option、Package、Config Search Path 等全部核心概念并理解它们背后的实现机制。术语总览Hydra 的所有配置行为都围绕一条主链路展开Input Configs输入配置→ 经过Defaults List默认列表与Overrides覆盖项的组合composition→ 产出Output Config输出配置交由应用消费。输入配置是构建输出配置的积木Defaults List 说明由哪些积木搭、怎么搭Overrides 是运行时对搭法的临时调整Config Group 与 Package 决定这些积木的组织方式与落点Config Search Path 决定去哪里找积木Plugins 则扩展整个框架的能力边界。下面逐一展开。Input Configs配置的输入形态输入配置Input Configs是用于构建应用所消费的 Output Config 的构建块它们可以通过放入 Config Group 来进行分组。Hydra 中主要有两种输入配置形态Config Files 与 Structured Configs。Config FilesYAML 配置文件Config File 是以 YAML 格式存在的输入配置它们可以存在于文件系统中也可以存在于 Python 模块中例如通过pkg://配置源加载见 Config Search Path。一个最简单的示例配置文件如下术语文档中的原始示例user: name: James Bond age: 7需要注意Hydra 配置文件必须使用.yaml扩展名。这一点在源码层面有硬性约束在 hydra/plugins/config_source.py 的_normalize_file_name方法中.yml扩展名会被直接拒绝并抛出ConfigLoadError(Unsupported config file extension .yml)其他缺少扩展名的文件名会自动补上.yaml。Structured Config带类型信息的配置Structured Config 一词在 Hydra 中有两层含义术语文档用 dataclass 或 attr.s 装饰的类或此类的一个实例并意图将其用作配置根据上述类或对象初始化出的 Config 对象。Structured Config 提供了额外的类型信息从而支持静态与运行时的类型检查。它有两种主要使用模式作为输入配置Input Config使用作为校验 Config File 与命令行参数的 Schema。dataclass class User: name: str age: int从源码角度看Structured Config 通过 hydra/core/config_store.py 中的ConfigStore.store()方法注册进配置仓库。store()接收name配置名、node可以是 DictConfig、ListConfig、Structured Config甚至是 dict 和 list、group配置组子组以/分隔例如hydra/launcher、package配置节点父层级子节点以.分隔例如foo.bar.baz以及provider提供该配置的模块/应用名便于调试。注册后配置通过 ConfigStoreWithProvider 以cs.store(name..., node...)的形式写入仓库并使用OmegaConf.structured(node)完成结构化转换。其他配置Primary Config 与 Output Config术语文档明确区分了两个容易混淆的概念Primary Config主配置在hydra.main()中或在Compose API中指定的输入配置。Output Config输出配置由hydra.main()或 Compose API 基于输入配置与 Overrides 组合compose出的配置。从源码看Compose API 的入口是 hydra/compose.py 中的compose(config_name, overrides, return_hydra_config)函数。它要求GlobalHydra已初始化即必须先使用hydra.main()或调用初始化方法然后调用GlobalHydra.instance().hydra.compose_config(...)完成组合当return_hydra_configFalse默认时会从结果中删除hydra节点后返回。Overrides运行时调整组合过程Overrides 是用于操纵配置组合过程的字符串可以更新、添加、删除配置值以及 Defaults List 选项。它们既可以用在命令行中也可以用在 Compose API 中。在下面的例子中keyvalue就是一个 override$ python my_app.py keyvaluecfg compose(config_name, overrides[keyvalue])在底层hydra/_internal/defaults_list.py 中的Overrides类负责解析所有外部 overriderepo.group_exists()/repo.config_exists()会判断 override 目标是配置组还是普通配置项删除类 override~key进入deletionsgroupvalue形式的追加进入append_group_defaults普通的groupvalue覆盖进入override_choices。如果一条 override 在组合结束后没有被消费ensure_overrides_used()hydra/_internal/defaults_list.py会抛出ConfigCompositionException并贴心提示 Did you mean to override one of ... 或建议用keyvalue追加。Defaults List配置组合的蓝图Defaults List 是输入配置中的一个列表它指示 Hydra 如何组合配置术语文档defaults: - db: mysql # An overridable defaults list entry - schema/school # A non-overridable defaults list entry其中db: mysql是可覆盖的 defaults list 条目overridableschema/school是不可覆盖的 defaults list 条目non-overridable。Defaults List 的组合过程在源码中有完整实现create_defaults_list()hydra/_internal/defaults_list.py会先构造以hydra/config与 primary config 为子节点的VirtualRoot见_create_roothydra/_internal/defaults_list.py再通过_create_defaults_tree_impl递归构建 defaults 树。每个输入的 Defaults List 条目会按逆序处理、最终以深度优先顺序生成扁平的ResultDefault列表_tree_to_listhydra/_internal/defaults_list.py。此外_validate_pathshydra/_internal/defaults_list.py还会校验路径合法性——无论操作系统如何Defaults List 中的路径分隔符只能是/反斜杠\与父路径穿越..都会被拒绝。Config Group配置组Config Group 是 Config Search Path 中包含输入配置的一个目录。Config Group 可以嵌套嵌套时路径元素统一使用正斜杠/分隔与操作系统无关术语文档。例如mi6/agent就是一个嵌套的配置组其下可存放james_bond.yaml等配置选项。Config Group Option配置组选项Config Group Option 是配置组中的一个输入配置。当用于 Defaults List 时一个 Config Group Option 可以是单个输入配置也可以是同一配置组下的输入配置列表术语文档。在源码中单个选项对应 hydra/core/default_element.py 的GroupDefault.is_name()分支而列表选项对应is_options()分支value为list类型。组合时hydra/_internal/defaults_list.py 会将选项列表中的每一项展开为独立的ConfigDefault子树。Package 与 Package Directive配置在输出中的落点Package是配置中一个节点的路径。默认情况下Config Group Option 的 Package 由其所在的 Config Group 推导而来术语文档。例如mi6/agent下的配置默认 Package 就是mi6.agent。Package Directive则用于指定一个 Config File 的根 Package它出现在 YAML 配置文件顶部术语文档详见 overriding_packages.md# package bond.jamesPackage 的推导逻辑在 hydra/core/default_element.py 的_get_final_package中实现默认情况下 package 取相对组路径并把/换成.若父包非空则拼接为父包.子包_global_前缀会被剥离ret[lgi len(_global_) 1:]用于表示全局根语义。Package Directive 的解析在 hydra/plugins/config_source.py 的_get_header_dict中凡是以# 开头的行都会被解析为头部指令headerpackage的值会被记录直到遇到第一个非头部行才停止解析。核心概念实例James Bond 输出配置术语文档用一个完整的 James Bond 示例串起了上述全部概念。三份配置分别如下config.yaml主配置defaults: - mi6/agent: james_bondmi6/agent/james_bond.yaml配置组选项含 Package Directive# package bond.james codename: 007最终组合出的 Output Configbond: james: codename: 007这个例子中每个概念都有明确的对应关系Input Configs输入配置config.yaml与mi6/agent/james_bond.yamlConfig Group配置组mi6/agentConfig Group Option配置组选项james_bondPackages包empty、mi6、mi6.agent、mi6.agent.codename从根到叶子节点的完整路径Package directive包指令# package bond.james将包含它的输入配置的默认 Package 从默认推导值mi6.agent覆盖为bond.james可以看到若没有 Package Directivejames_bond.yaml的内容将默认落在mi6.agent包下而# package bond.james将其重定向到bond.james于是输出配置中出现了bond.james.codename的层级结构。Config Search Path配置搜索路径Config Search Path 是一个按顺序搜索以查找配置的路径列表与 Python 的 PYTHONPATH 类似术语文档详见 search_path.md。搜索规则与 schema 前缀当请求某个配置时搜索路径中第一个匹配的配置被使用。每个搜索路径元素带有一个 schema 前缀如file://或pkg://对应一个ConfigSourcePluginfile://指向文件系统路径可为绝对路径或相对路径相对路径基于当前工作目录解析且所有操作系统上统一使用/作为路径分隔符。pkg://指向一个可导入的 Python 模块以.作为分隔符目录中需要__init__.py文件才会被 Python 视为包。你可以通过--info标志查看搜索路径与 Hydra 实际加载的配置$ python my_app.py --info searchpath从源码看schema 与配置源插件的对应关系定义在 hydra/plugins/config_source.py 的ConfigSource抽象基类中每个实现类必须声明自己的scheme()例如file或pkg并实现load_config()、is_group()、is_config()、available()、list()等接口。仓库内置的实现包括 file_config_source.py 与 importlib_resources_config_source.py 等。修改搜索路径的几种方式使用hydra.main()通过config_path参数指定该路径相对 Python 脚本所在位置。覆盖hydra.searchpath配置可在主配置中定义也可从命令行覆盖。注意hydra.searchpath只能在主配置中配置在其他配置中配置会报错。例如defaults: - dataset: cifar10 hydra: searchpath: - pkg://additional_conf # You can also use file based schema: # - file:///etc/my_app # - file://${oc.env:HOME}/.my_app命令行覆盖方式$ python my_app.py hydra.searchpath[pkg://additional_conf]覆盖命令行--config-dir一种灵活性较低的替代方案详见 hydra-command-line-flags.md。创建SearchPathPlugin框架作者可以在包安装后自动把配置加入搜索路径无需用户操作。可参考 example_searchpath_plugin 示例插件。Plugins插件体系Plugins 扩展 Hydra 的能力。Hydra 拥有多种插件类型例如 Launcher 与 Sweeper术语文档。仓库中维护着多个官方插件覆盖各类启动器与搜索器例如Launcher 类hydra_joblib_launcher、hydra_submitit_launcher、hydra_ray_launcher、hydra_rq_launcherSweeper 类hydra_ax_sweeper、hydra_nevergrad_sweeper、hydra_optuna_sweeper其他hydra_colorlog从源码接口看Launcher 插件继承自 hydra/plugins/launcher.py 的Launcher抽象类需要实现setup()配置启动器实例与launch()接收一批 job 覆盖参数与初始 job 索引返回JobReturn序列。Sweeper 插件继承自 hydra/plugins/sweeper.py 的Sweeper抽象类需要实现setup()与sweep()接收描述扫描行为的参数列表执行扫描并返回所有启动任务的结果。Sweeper.validate_batch_is_legal()还会在启动前预组合每个 batch以尽早发现组合失败。此外 ConfigSource 本身也是一种插件对应file://、pkg://等 schema另有SearchPathPlugin、CompletionPlugin等类型见 hydra/plugins 目录。概念关系速查表下表总结了各核心术语的关键要点便于速查术语含义关键要点Input Config构建 Output Config 的积木分为 Config FileYAML与 Structured Configdataclass/attr.s两种形态Primary Config在hydra.main()或 Compose API 中指定的主输入配置是组合过程的根Output Config组合后的最终配置由 Input Configs Overrides 组合产出Overrides操纵组合过程的字符串可更新/添加/删除配置值与 Defaults List 选项命令行与 Compose API 均可用Defaults List输入配置中的组合蓝图列表条目可覆盖db: mysql或不可覆盖schema/schoolConfig Group搜索路径中包含输入配置的目录可嵌套路径分隔符统一为/Config Group Option配置组中的输入配置可以是单个配置或同组配置列表Package配置中节点的路径默认由 Config Group 推导mi6/agent→mi6.agentPackage Directive指定配置文件根 Package 的头部指令以# package xxx形式写在 YAML 顶部Config Search Path按顺序查找配置的路径列表类似 PYTHONPATH元素带file:///pkg://schema 前缀Plugins扩展 Hydra 能力的模块主要有 Launcher、Sweeper、ConfigSource、SearchPathPlugin 等类型小结Hydra 的术语体系虽多但彼此环环相扣输入配置Config File / Structured Config是素材配置组Config Group / Config Group Option是素材的组织方式Defaults List 是组合蓝图Overrides 是运行时调整Package 决定素材在输出配置树中的落点Config Search Path 决定素材从何处来而 Plugins 则扩展了框架处理这些素材的能力。掌握这套术语后无论是阅读 Hydra 的报错信息、编写自己的配置还是开发插件你都能快速定位到对应机制——文档首页的 术语页 与源码目录 hydra/_internal 与 hydra/core 是继续深入的最佳起点。【免费下载链接】hydraHydra is a framework for elegantly configuring complex applications项目地址: https://gitcode.com/GitHub_Trending/hyd/hydra创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考