Faiss项目编译时CMake无法找到RAFT库的解决方案

在Ubuntu 20.04系统上编译Faiss项目时，当启用RAFT支持(FAISS_ENABLE_RAFT=ON)时，CMake配置阶段会出现找不到RAFT库的问题。这个问题在Faiss的最新main分支和v1.9.0版本中都存在。

问题现象

在配置阶段，CMake会报告以下错误：

CMake Warning at CMakeLists.txt:83 (find_package):
  By not providing "Findraft.cmake" in CMAKE_MODULE_PATH this project has
  asked CMake to find a package configuration file provided by "raft", but
  CMake did not find one.

随后在生成阶段会出现更严重的错误：

CMake Error at faiss/gpu/CMakeLists.txt:336 (target_link_libraries):
  Target "faiss_gpu" links to:
    raft::raft
  but the target was not found.

问题分析

这个问题源于Faiss项目对RAFT库的依赖管理方式。RAFT是NVIDIA RAPIDS生态系统中的一个库，用于加速向量搜索和聚类算法。在Faiss中启用GPU支持时，RAFT提供了额外的加速功能。

CMake的find_package机制无法自动定位RAFT库的安装位置，这是因为：

1. RAFT库没有提供标准的Findraft.cmake模块文件
2. 系统中可能没有安装RAFT库的开发包
3. RAFT库的安装路径没有被正确添加到CMAKE_PREFIX_PATH环境变量中

解决方案

目前最可靠的解决方法是使用conda环境安装RAFT库：

1. 安装Miniconda
2. 创建并激活conda环境
3. 在conda环境中安装RAFT库
4. 然后重新运行CMake配置

这种方法确保CMake能够通过conda环境的路径找到RAFT库的配置文件。

额外发现：MKL链接问题

在调试过程中还发现一个相关问题：当设置DBLA_VENDOR=Intel10_64lp时，虽然CMake报告找不到MKL，但实际上仍然能正确链接BLAS库。如果不设置这个变量，CMake能找到MKL但会链接到性能较低的gomp而非iomp5。

这个现象表明Faiss的MKL检测机制与实际的链接行为存在不一致，建议在性能敏感的场景下明确指定BLAS供应商。

未来展望

值得注意的是，NVIDIA正在将RAFT中的向量搜索算法迁移到新的cuVS库中。根据RAPIDS项目的规划，RAFT中的向量搜索功能将在24.12版本中完全移除。因此，Faiss项目未来可能会转向使用cuVS库来替代当前的RAFT集成。

对于开发者而言，建议关注这一迁移过程，以便及时调整项目配置。同时，使用conda环境管理依赖仍然是当前最可靠的解决方案。