River项目构建问题解析：从源码构建失败的原因与解决方案

River是一个流行的Python机器学习库，它采用了Rust扩展来提升性能。最近有用户反馈无法从PyPI下载的源码包(sdist)成功构建River项目，本文将深入分析这一问题的原因并提供解决方案。

问题现象

当用户尝试从PyPI下载River的源码包并构建时，构建过程会失败并报错："error: can't find manifest for Rust extension river.stats._rust_stats at path Cargo.toml"。然而，直接从GitHub仓库构建却能成功。

根本原因

经过分析，这个问题源于River项目从传统的setup.py构建系统迁移到Poetry构建工具的过程中出现的配置遗漏。具体来说：

1. 传统Python项目使用MANIFEST.in文件来指定需要包含在源码分发包(sdist)中的额外文件
2. River项目的MANIFEST.in中明确包含了Cargo.toml文件(用于Rust构建)和其他必要文件
3. 但Poetry构建工具默认不会处理MANIFEST.in文件，而是通过pyproject.toml来管理构建配置

由于这个原因，当项目切换到Poetry后，关键的Cargo.toml文件没有被包含在发布的源码包中，导致构建失败。

解决方案

解决这个问题的正确方式是将所有必要的文件包含配置从MANIFEST.in迁移到pyproject.toml中。具体需要：

1. 在pyproject.toml的[tool.poetry]部分添加include配置
2. 确保所有原先在MANIFEST.in中指定的文件(特别是Cargo.toml和Rust源码)都被正确包含
3. 测试从生成的sdist包构建是否成功

技术背景

对于混合Python和Rust的项目，构建过程需要注意以下几点：

1. Rust扩展需要Cargo.toml文件来描述构建配置
2. 构建工具需要知道如何处理和编译Rust代码
3. 源码分发包必须包含所有必要的构建文件，而不仅仅是Python代码

Poetry作为现代Python项目的构建工具，虽然简化了很多配置，但在处理混合语言项目时需要注意这些细节。

最佳实践

对于类似的项目维护者，建议：

1. 在迁移构建系统时，全面检查所有构建依赖项
2. 测试从源码包构建而不仅是从仓库构建
3. 对于混合语言项目，特别注意非Python文件的包含
4. 定期验证发布流程，确保发布的包可以正确构建

对于River用户，如果遇到类似构建问题，可以暂时从GitHub仓库直接构建，同时等待修复版本发布。