pip 忽略 OmegaConf 2.0.6：PyYAML 的 >=5.1.* 写法无效

安装 Fairseq 等旧项目时，pip 反复提示忽略 OmegaConf 的若干版本，日志指出 PyYAML (>=5.1.*) 的 .* 只能配合 == 或 !=。先处理这条候选包元数据错误，不要只追着最后的 wheel 构建失败安装编译器。

OmegaConf 2.0.6 的正式 wheel 中，Requires-Dist 确实包含这份无效依赖声明。pip 24.1 起不再接受相应非标准依赖说明，当前 pip 26.2.1 仍会在验证候选产物时拒绝它。

版本存在，也可能被解析器排除

完整日志中通常先出现：

Ignoring version 2.0.6 of omegaconf since it has invalid metadata
.* suffix can only be used with `==` or `!=` operators
PyYAML (>=5.1.*)

这说明 pip 已经找到并读取了候选包，只是不能接受它的依赖语法。清缓存、换镜像或先装一份 PyYAML，不会修正同一个 wheel 中的声明。

>=5.1 表示允许 5.1 及以上，==5.1.* 表示匹配 5.1 这一版本前缀。它们不是相同的兼容承诺，不能为了保留星号就把 >= 改成 ==。若是自己的包，应按真正的依赖意图修正源码声明，再构建并检查产物元数据。

先找是谁把 OmegaConf 限在旧范围

保留原 Python、pip、平台、项目锁定输入和完整解析日志。检查 Fairseq、Hydra 与 OmegaConf 之间的实际上下界，不要只看当前环境已经安装了哪些包。

例如消费方要求 omegaconf<2.1 时，直接安装一个更高版本并不能满足原依赖；它可能引入配置行为变化，或者被下一次解析重新替换。应优先评估仍受维护、依赖元数据有效且与项目接口兼容的消费方版本，再用完整依赖图验证。

若必须维护旧项目，可以由项目负责人审查并维护自己的修复产物：明确原依赖意图、修正声明、构建完整包，并使用受控的身份、来源与哈希进入项目安装流程。不要在已安装的 .dist-info 中随手改文字，或篡改公共 wheel 后继续沿用原产物哈希。

修复声明后还要检查应用的配置加载、合并规则和调用接口。让 pip 接受一个候选版本，只完成了安装路径的一步，不证明模型、训练或推理任务已兼容。

日志最后的 version.txt 可能是后续错误

解析器排除一批候选后，可能尝试另一个 Fairseq 版本，随后源码构建报 fairseq/version.txt 不存在。这是后续候选的构建问题，与前面的 OmegaConf 元数据校验分属不同阶段。

先确认被忽略的版本为何不符合条件，再检查后续产物是否完整、构建入口是否适用。补一个 version.txt、加装 C++ 工具链或关闭构建隔离，都不能让旧 wheel 的 >=5.1.* 自动变成有效语法。

旧 pip 只能作为遗留环境的兼容选择

日志会提示需要该版本时使用 pip<24.1。这能解释为什么某些历史环境仍能安装旧产物，不应成为所有 Python 项目的全局降级指令。

如果确实无法马上迁移，保持这套遗留工具、Python 与应用依赖在独立可重建环境里，按已有项目流程固定完整组合，并安排后续修复。旧解析器接受元数据，不保证 Fairseq 与任意 Python、Windows 或 GPU 环境都能工作；另一台机器的安装反馈不能代替当前环境验收。

验证时从干净环境运行原安装入口，确认没有再忽略审定的依赖产物，检查实际版本及业务功能。保存原声明、锁文件、工具版本和产物；回退时恢复匹配的环境组合。若最后仍有构建异常，按最早的有效错误继续定位，不把“换了 pip”当作整个任务已经完成。

如果依赖语法本身有效，报错却来自声明的 Python 支持范围，可另查Poetry 为什么会为整个 Python 范围求解。