Pyinstaller ImportError with scipy: DLL加载失败

PyInstaller 在打包包含 SciPy 的 Python 应用程序时遇到 ImportError: DLL load failed 错误，通常是由于缺少某些依赖项或 DLL 文件导致的。以下是一些基础概念和相关解决方案：

基础概念

1. PyInstaller: 一个用于将 Python 应用程序打包成独立可执行文件的工具。
2. SciPy: 一个用于科学计算的 Python 库，依赖于 NumPy 和其他底层库。
3. DLL (Dynamic Link Library): 动态链接库，Windows 操作系统上的一种共享库文件格式。

可能的原因

1. 缺少依赖项: SciPy 依赖于许多底层库，如 MKL、OpenBLAS 等，这些库可能没有被正确包含在打包后的可执行文件中。
2. 路径问题: 打包后的可执行文件无法找到所需的 DLL 文件。
3. 版本不兼容: 使用的 SciPy 版本与 PyInstaller 不兼容。

解决方案

方法一：使用 --hidden-import 和 --add-binary

确保所有必要的模块和库都被正确包含：

pyinstaller --hidden-import=scipy --add-binary "path_to_mkl_dll;mkl" your_script.py

方法二：使用 hook 文件

创建一个自定义的 hook 文件来确保所有依赖项都被正确包含。

1. 创建一个名为 hook-scipy.py 的文件，内容如下：

from PyInstaller.utils.hooks import collect_dynamic_libs

binaries = collect_dynamic_libs('scipy')

1. 在打包时指定 hook 文件：

pyinstaller --additional-hooks-dir=. your_script.py

方法三：使用 conda 环境

如果你使用的是 Anaconda 或 Miniconda，可以尝试在 conda 环境中安装 SciPy 并使用 PyInstaller 打包：

conda create -n myenv python=3.x scipy
conda activate myenv
pip install pyinstaller
pyinstaller your_script.py

方法四：检查依赖项

确保所有依赖项都已正确安装。你可以使用 pip 或 conda 来安装 SciPy 及其依赖项：

pip install scipy

或

conda install scipy

示例代码

假设你有一个简单的 Python 脚本 example.py，使用了 SciPy：

import scipy.stats as stats

data = [1, 2, 3, 4, 5]
mean = stats.mean(data)
print(f"Mean: {mean}")

你可以使用以下命令进行打包：

pyinstaller --hidden-import=scipy --add-binary "path_to_mkl_dll;mkl" example.py

应用场景

这种方法适用于需要将包含 SciPy 的 Python 应用程序打包成独立可执行文件的场景，例如：

• 桌面应用程序: 需要在没有 Python 环境的机器上运行。
• 自动化脚本: 需要在不同环境中一致地运行。
• 部署到生产环境: 确保所有依赖项都被正确打包和分发。

通过以上方法，你应该能够解决 PyInstaller 打包 SciPy 时遇到的 ImportError: DLL load failed 错误。