源代码构建#

注意

如果您只是尝试安装 SciPy，我们建议使用二进制文件 - 有关详细信息，请参阅安装。

从源代码构建 SciPy 需要首先设置系统级依赖关系（编译器、BLAS/LAPACK 库等），然后再调用构建。构建可以用来安装 SciPy 以进行本地使用、开发 SciPy 自身或构建可再发行的二进制包。并且可能希望自定义构建执行方式的各个方面。本指南将涵盖所有这些方面。此外，它还提供了有关 SciPy 构建工作原理的背景信息，以及链接到相关的通用 Python 构建与打包文档的最新指南。

从源代码构建 SciPy#

如果您只想从源代码安装一次 SciPy，而不是进行任何开发工作，那么构建和安装的推荐方法是使用 pip。否则，建议使用 conda。

注意

如果您还没有 conda 安装，我们建议使用 Mambaforge；不过，任何 conda 版本都适用。

从源代码构建以使用 SciPy#

Conda 环境

如果您使用的是 conda 环境，则 pip 仍然是用于调用 SciPy 从源代码构建的工具。始终对 pip install 命令使用 --no-build-isolation 标志，以避免针对来自 PyPI 的 numpy 轮进行构建非常重要。为了使其能够发挥作用，您必须首先安装其余构建依赖项到 conda 环境

# Either install all SciPy dev dependencies into a fresh conda environment
mamba env create -f environment.yml

# Or, install only the required build dependencies
mamba install python numpy cython pythran pybind11 compilers openblas meson-python pkg-config

# To build the latest stable release:
pip install scipy --no-build-isolation --no-binary scipy

# To build a development version, you need a local clone of the SciPy git repository:
git clone https://github.com/scipy/scipy.git
cd scipy
git submodule update --init
pip install . --no-build-isolation

虚拟环境或系统 Python

# To build the latest stable release:
pip install scipy --no-binary scipy

# To build a development version, you need a local clone of the SciPy git repository:
git clone https://github.com/scipy/scipy.git
cd scipy
git submodule update --init
pip install .

从源代码构建以进行 SciPy 开发#

如果您希望从源代码构建以处理 SciPy 本身，首先克隆 SciPy 代码库

git clone https://github.com/scipy/scipy.git
cd scipy
git submodule update --init

然后您需要执行以下操作

创建专用开发环境（虚拟环境或 conda 环境），
安装所有必需的依赖项（构建以及测试、文档和可选依赖项），
使用我们的 dev.py 开发人员界面构建 SciPy。

第 (3) 步始终相同，第 (1) 步和第 (2) 步在 conda 和虚拟环境之间不同

Conda 环境

若要创建一个已安装所有必需和可选依赖项的 scipy-dev 开发环境，请运行

mamba env create -f environment.yml
mamba activate scipy-dev

虚拟环境或系统 Python

注意

有多种工具可以管理虚拟环境，例如 venv、virtualenv/virtualenvwrapper、pyenv/pyenv-virtualenv、Poetry、PDM、Hatch 等。这里我们使用 Python 标准库的一部分，即基本的 venv 工具。你可以使用任何其他工具；我们只需要一个已激活的 Python 环境。

在名为 venv 的新目录中创建并激活一个虚拟环境（注意，准确的激活命令可能因你的操作系统和 shell而异，请参阅 venv 文档中的“How venvs work”）。

Linux

python -m venv venv
source venv/bin/activate

macOS

python -m venv venv
source venv/bin/activate

Windows

python -m venv venv
.\venv\Scripts\activate

然后，使用以下命令从 PyPI 安装 Python 级依赖项（参见 pyproject.toml）

# All dependencies
python -m pip install -r requirements/all.txt

# Alternatively, you can install just the dependencies for certain
# development tasks:

# Build and dev dependencies (for `python dev.py {build, lint, mypy}`)
python -m pip install -r requirements/build.txt -r requirements/dev.txt

# Doc dependencies (for `python dev.py {doc, refguide-check}`)
python -m pip install -r requirements/doc.txt

# Test dependencies (for `python dev.py {test, bench, refguide-check}`)
python -m pip install -r requirements/test.txt

要在已激活的开发环境中构建 SciPy，请运行

python dev.py build

这将在存储库内（默认情况下在 build-install 目录中）安装 SciPy。然后，你可以运行测试（python dev.py test）、进入 IPython（python dev.py ipython），或采取其他开发步骤，例如构建 HTML 文档或运行基准测试。dev.py 接口是自文档化的，因此请参阅 python dev.py --help 和 python dev.py <subcommand> --help 以获取详细指南。

IDE 支持和可编辑安装

虽然 dev.py 接口是我们推荐的处理 SciPy 的方法，但它有一个限制：由于自定义安装位置，使用 dev.py 安装的 SciPy 不会在 IDE 中自动识别（例如，通过“运行”按钮运行脚本或可视化设置断点）。这在就地构建（或“可编辑安装”）中效果更佳。

支持可编辑安装。务必要了解，在给定的存储库克隆中，你可以使用可编辑安装或 dev.py，但不能同时使用这两者。如果你使用可编辑安装，则必须直接使用 pytest 和其他开发工具，而不是使用 dev.py。

要使用可编辑安装版，请确保从一个干净的仓库开始（如果您之前用 dev.py 构建过，则运行 git clean -xdf），并且已正确设置好本页上面描述的所有依赖项。然后执行

# Note: the --no-build-isolation is important! meson-python will
# auto-rebuild each time SciPy is imported by the Python interpreter.
pip install -e . --no-build-isolation

# To run the tests for, e.g., the `scipy.linalg` module:
pytest scipy/linalg

对 SciPy 代码进行更改（包括对编译后的代码进行更改）时，无需手动重新构建或重新安装。当您运行 git clean -xdf（这会移除构建的扩展模块）时，请记得使用 pip uninstall scipy 卸载 SciPy。

有关底层工作原理的更多详细信息，请参阅关于可编辑安装版的 meson-python 文档。

源代码构建#

系统级依赖关系#

从源代码构建 SciPy#

从源代码构建以使用 SciPy#

从源代码构建以进行 SciPy 开发#

自定义构建#

背景信息#