如何通过requirements.txt安装带extras的GitHub版Haystack依赖

报错原因 #

之前的写法出问题核心是两点：

• 配置git来源依赖时没有指定分支、标签或commit哈希，pip不会默认拉取仓库最新主分支代码，而是会遍历仓库所有历史版本标签做匹配，最终检出到0.1.0这类非常早期的版本，该版本尚未集成ray等可选组件，因此会弹出extra不存在的警告。
• 旧版本pip对PEP 508格式的带extras的git源依赖解析存在已知bug，校验依赖元数据时会错误匹配历史版本信息，最终触发dill包版本元数据不匹配的报错。

正确配置 #

根据使用场景选择对应的单行配置写入requirements.txt即可：

• 拉取主分支最新开发版：

farm-haystack[all] @ git+https://github.com/deepset-ai/haystack.git@main

• 生产环境推荐固定到具体发布标签，稳定性更高：

farm-haystack[all] @ git+https://github.com/deepset-ai/haystack.git@v1.25.2

安装注意事项 #

• 安装前先升级pip到最新版本，执行命令pip install --upgrade pip，升级后即可解决dill元数据不匹配的报错。
• 不需要全量功能时不要加[all]标记，按需选择对应可选依赖即可（比如仅需Elasticsearch支持就写farm-haystack[elasticsearch]），能大幅降低依赖冲突概率。
• 生产环境不要直接拉取浮动的主分支，最好固定到具体的commit哈希或正式发布版本，避免上游代码更新引入破坏性变更。

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