解决 Python pip 报错 Preparing metadata (pyproject.toml) failed

解决 Python pip 报错 Preparing metadata (pyproject.toml) failed

现象

python 版本为 3.13.5，自动安装 numpy 时发生报错。

发现

在报错末尾我们发现有段日志：

ninja: build stopped: subcommand failed.

经查询，ninja 是一种编译工具，类似 cmake。而 ninja 更新速度可能跟不上，导致自动安装的 numpy 版本过高，即便是最新的 ninja 也无法编译最新的 numpy，从而报错。

解决方法

降低 numpy 的版本。

NumPy 与 Python 版本兼容表

NumPy 版本	兼容的 Python 版本
>2.1	3.13
1.26.0	3.9-3.12
1.25.0	3.9-3.11
1.24.0	3.8-3.11
1.23.0	3.8-3.10
1.22.0	3.8-3.10
1.21.0	3.7-3.9

尝试安装 2.1.0 版本后，安装成功。