错误:子进程退出失败:python setup.py egg_info 未成功运行。退出码:1。Cython 编译器错误:/tmp/pip-install-xxx/package/src/foo.pyx:1:0:找不到 'bar.pxd'
error: subprocess-exited-with-error: python setup.py egg_info did not run successfully. exit code: 1. Cython.Compiler.Errors.CompileError: /tmp/pip-install-xxx/package/src/foo.pyx:1:0: 'bar.pxd' not found
ID: pip/egg-info-failure-requires-cython
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| pip 23.2 | active | — | — | — |
| pip 24.0 | active | — | — | — |
| setuptools 68.0 | active | — | — | — |
| Cython 3.0.8 | active | — | — | — |
根因分析
该软件包需要一个 Cython 扩展文件(.pxd),但该文件在源代码分发包中缺失,通常是因为生成该文件的构建脚本在打包前未运行。
English
The package requires a Cython extension file (.pxd) that is missing from the source distribution, often because it is generated by a build script that was not run before packaging.
官方文档
https://pip.pypa.io/en/stable/topics/build-system/解决方案
-
从版本控制系统(如 git)安装该软件包,其中包含生成 .pxd 文件的构建脚本:pip install git+https://github.com/user/package.git
-
修补源代码分发包:下载 .tar.gz,解压,运行构建脚本(如 python setup.py build_ext --inplace)生成缺失的 .pxd,然后重新打包并用 pip install ./package-version.tar.gz 安装。
-
联系软件包维护者,请求发布包含缺失 .pxd 文件的固定源代码分发包或 wheel。
无效尝试
常见但无效的做法:
-
Manually creating a dummy .pxd file with the same name in the package directory
95% 失败
The .pxd file has specific type declarations and interfaces that must match the .pyx file; a dummy file will cause compilation errors or silent failures.
-
Running pip install --no-build-isolation to use system Cython
90% 失败
The missing .pxd is not a Cython version issue; it's a missing source file that no Cython version can generate without the original build script.
-
Installing the package from a pre-built wheel instead of source
70% 失败
If the package maintainer did not publish a wheel for the platform/Python version, this option is not available.