SaveIndex 和 LoadIndex 函数必须用 C++/CLI 或 P/Invoke 调用
Faiss 是 C++ 库，C# 没有原生
SaveIndex/
LoadIndex方法。直接 NuGet 安装的
faiss-csharp（如 FaissSharp）多数只封装了索引构建和搜索，不带序列化能力——这是最常被误以为“支持持久化”的坑。
实际路径只有两条：
用DllImport手动绑定 Faiss 的
faiss_write_index和
faiss_read_indexC 接口（推荐，控制力强） 通过 C++/CLI 写一层薄包装，导出托管方法（适合已有 C++ 构建流程的项目）
别信某些封装库文档里写的 “
index.Save("path.bin")” —— 那是假接口，运行时抛 NotImplementedException或静默失败。
保存前必须确保索引已训练且未被释放
常见错误是调用
SaveIndex时传入未训练的
IndexIVFFlat或已
Delete的指针，结果保存的是空/损坏文件，加载时报
Invalid argument: Invalid header或直接崩溃。
关键检查点：
index.IsTrained返回
true（对
IndexIVF*类型尤其重要） C++ 侧没调过
faiss::Index::reset()或 delete 原生指针 如果用了多线程构建，确保保存前所有
add()已完成且无竞态
示例判断逻辑（P/Invoke 场景）：
if (!FaissNative.faiss_Index_is_trained(indexPtr)) { throw new InvalidOperationException("Index not trained"); }
文件路径和内存对齐影响跨平台加载
在 Windows 上用
faiss_write_index保存的 .bin 文件，默认含 Windows 特定字节序和 padding；直接丢到 Linux 容器里用
faiss_read_index加载，大概率触发
std::bad_cast或段错误。
解决方案不是“换平台重训”，而是统一用二进制兼容模式：
保存时强制指定faiss::IO_FLAG_MMAP标志（需 Faiss ≥ 1.7.4） 或改用
faiss::write_index+
faiss::IOWriter自定义 writer，禁用压缩、固定字节序 路径避免中文和空格——
faiss_read_index在某些旧版本会因路径 decode 失败静默返回 null
验证是否成功：用 Python Faiss 加载同一文件，执行
index.ntotal看是否匹配预期向量数。
加载后务必调用 index.Shard
或显式设置 nprobe
从磁盘加载的 IVF 类索引，
nprobe默认为 1，即使你之前设过 16。这不是 bug，是 Faiss 的设计：序列化只存结构和向量，不存查询参数。
漏掉这步会导致搜索结果质量断崖式下降，但又不报错，极难排查。
对IndexIVFFlat：
FaissNative.faiss_IndexIVF_set_nprobe(indexPtr, 16)对
IndexIVFPQ：同样要设
nprobe，还建议调
faiss_IndexIVF_reset_fast_scan避免缓存残留 若用 GPU 版本，加载后需再调
faiss::gpu::index_cpu_to_gpu，不能直接搜
这个点没有银弹——每次
LoadIndex后，你的代码必须显式恢复业务所需的查询配置。
真正麻烦的从来不是“怎么存”，而是“存完怎么让下一次加载的行为和上次完全一致”。参数、训练状态、设备上下文、甚至 Faiss 版本小号（1.7.3 vs 1.7.4）都可能让同一个 .bin 文件表现不同。
