无法安装llama-index-finetuning-cross-encoders包，求正确安装方法

API 探路者

2026-6-27

解决llama-index-finetuning-cross-encoders安装失败的问题

针对你遇到的找不到该包的问题，试试以下几种解决方法：

确认包名并尝试安装核心微调包
可能官方文档的包名存在偏差，或是cross-encoder的微调功能已整合到llama-index-finetuning包中。执行以下命令安装核心微调包：
```
pip install llama-index-finetuning
```
安装完成后，再检查教程中的代码是否能正常调用cross-encoder相关功能。
升级LlamaIndex核心包到最新版本
旧版本的LlamaIndex可能不支持这个子包，先升级核心包：
```
pip install --upgrade llama-index
```
之后再尝试安装目标包，或直接使用核心微调包中的功能。
从GitHub源码安装
如果该包还未正式发布到PyPI，只能从源码安装：
1. 克隆LlamaIndex官方仓库：
```
git clone https://github.com/run-llama/llama_index.git
```
2. 进入cross-encoder微调包的目录：
```
cd llama_index/finetuning/llama-index-finetuning-cross-encoders
```
3. 本地安装该包：
```
pip install .
```
检查文档是否超前于包发布
有时候官方文档会提前更新，但对应的包还未上线PyPI。这时候可以查看LlamaIndex仓库的最新提交记录，确认该包的发布状态，或等待官方正式发布。