從原始碼建置#

注意

如果您只是想安裝 SciPy，我們建議使用二進位檔案 - 有關詳細資訊，請參閱安裝。

從原始碼建置 SciPy 需要先設定系統層級的依賴項（編譯器、BLAS/LAPACK 程式庫等），然後調用建置程序。建置的目的是為了在本機使用而安裝 SciPy、開發 SciPy 本身，或建置可重新發佈的二進位套件。並且可能需要自訂建置的各個方面。本指南將涵蓋所有這些方面。此外，它還提供有關 SciPy 建置工作原理的背景資訊，並連結到最新的通用 Python 建置與封裝相關文件指南。

從原始碼建置 SciPy#

如果您只想從原始碼安裝 SciPy 一次，而不進行任何開發工作，那麼建議的建置和安裝方式是使用 pip。否則，建議使用 conda。

注意

如果您還沒有 conda 安裝，我們建議使用 Miniforge；任何 conda 版本都可以。

從原始碼建置以使用 SciPy#

Conda 環境

如果您使用 conda 環境，pip 仍然是您用來調用 SciPy 原始碼建置的工具。務必始終將 --no-build-isolation 標誌用於 pip install 命令，以避免針對來自 PyPI 的 numpy wheel 進行建置。為了使其正常運作，您必須先將剩餘的建置依賴項安裝到 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 等。在這裡，我們使用基本的 venv 工具，它是 Python stdlib 的一部分。您可以使用任何其他工具；我們只需要一個已啟用的 Python 環境。

在名為 venv 的新目錄中建立並啟用虛擬環境（請注意，確切的啟用命令可能因您的作業系統和 shell 而異 - 請參閱 venv 文件中的「虛擬環境如何運作」）。

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.ps1

然後使用以下命令從 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

這會將 SciPy 安裝在儲存庫內（預設情況下在 build-install 目錄中）。然後您可以執行測試 (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 開發#

自訂建置#

背景資訊#