提示缺少 hydra，先核对 hydra-core；配置文件找不到是另一条排查路线
Hydra 的导入名和常见分发包名不同。模块缺失与配置搜索路径错误要分别处理，不要把工作流导入失败归结为随便安装一个同名包。
现象与适用范围
Hydra 的导入名和常见分发包名不同。模块缺失与配置搜索路径错误要分别处理，不要把工作流导入失败归结为随便安装一个同名包。
检索片段；具体版本与异常上下文可能不同：
No module named 'hydra'
MissingConfigException
已核对的依据
Hydra 官方入门说明使用 hydra-core 作为安装分发包，并通过 hydra 导入。其配置系统独立于 Python 包的安装状态，配置入口和搜索路径需要与应用约定一致。 V04-HYDRA
需要区分的情况
1. 安装了不相关的同名分发包，或真正的 hydra-core 不在目标解释器中。
2. 导入成功，但配置搜索路径指向了别处。@hydra.main(config_path=...) 的相对路径以定义它的脚本为基准；相对 file:// 搜索路径才以进程工作目录为基准。
3. 配置存在但缺少引用的配置组、覆盖项或与当前应用版本不一致。
建议的排查顺序
以下为本站编排的操作建议，不表示已定位你的具体环境。
1. 读取节点依赖声明及实际环境中 hydra-core 的元数据，确认异常是 ModuleNotFoundError 还是配置相关异常。
2. 对缺包安装节点支持的分发版本；不要自动删除别的包，先记录现有环境并确认同名冲突的具体来源。
3. 对配置异常保留完整搜索路径及缺失名称，检查仓库是否完整、配置版本是否匹配；先按实际 Hydra 入口解析每个路径，再考虑是否需要改变启动目录。
4. 按节点作者支持的配置入口或明确路径启动最小测试，再逐项加回配置覆盖。不要复制另一项目的 YAML 来让错误暂时消失。
怎样判断这一层已解决
应用读取到预期配置并能解析必要配置组，最小操作完成。仅能 import hydra 不表示配置链条完整。
注意事项和适用边界
不建议全局改变工作目录或添加任意 PYTHONPATH 来掩盖部署错误。公开日志中的配置可能包含密钥，分享前必须脱敏。
资料核对：2026-09-27。本站未执行安装、GPU 推理或用户环境修复。
原始来源
- Hydra introduction · 2026-09-27
- Hydra config search path · 2026-09-27
相关排查
排查下一个可能的原因
同样的现象可能来自不同原因。可以按顺序查看下面这些相关条目。
把完整日志粘贴到报错排查工具这篇内容对你有帮助吗？
匿名统计，只记录“有/没有帮助”的计数，不记录账号、IP 地址或设备信息。
资料来源
基于上游资料独立编写的草稿，未运行验证；版本观察限定到对应资料，未知封装身份明确保留。
01Hydra introduction资料核对: 2026-09-2702Hydra config search path资料核对: 2026-09-27报告问题 · 66e444dc-b197-528b-9dea-0d48cf317a0c
相关阅读
编辑为本页关联的条目。
用环境信息、单次变更和相同输入记录排查过程，区分安装记录、依赖检查和真实运行。