PySide6项目Nuitka编译NumPy相关警告与导入错误求助

云上老周

2026-6-25

问题解决：PySide6-Deploy（Nuitka）打包NumPy的DLL警告与ImportError

1. 解决Nuitka关于NumPy的DLL警告

原因

Nuitka的DLL处理插件未适配你使用的NumPy 1.26.4版本，导致无法自动识别并打包NumPy依赖的DLL文件。

解决步骤

更新Nuitka到最新版本：当前使用的1.5.4版本对NumPy 1.26.x的适配不完善，更新到新版本可修复插件的DLL识别逻辑：
```
pip install --upgrade nuitka
```
手动指定NumPy DLL路径：若更新后警告仍存在，在pysidedeploy.spec的[nuitka]区块extra_args中添加参数，强制包含NumPy的DLL目录（以你的Anaconda环境为例）：
```
extra_args = --quiet --noinclude-qt-translations=True --include-data-files=C:\Users\damie\anaconda3\envs\qutee\Lib\site-packages\numpy\.libs\*=.libs/
```
强制处理NumPy依赖：添加--force-stdlib-imports=numpy参数，让Nuitka优先处理NumPy的标准导入逻辑，确保依赖被完整打包：
```
extra_args = --quiet --noinclude-qt-translations=True --force-stdlib-imports=numpy
```

2. 解决NumPy的ImportError

成因

代码中提前修改sys.path的逻辑，导致打包后的程序运行时，NumPy的路径检测误判当前目录为源码目录；同时Anaconda环境下的NumPy结构与普通pip安装版本存在差异，加剧了路径识别问题。

解决步骤

限制sys.path修改的场景：仅在开发环境添加上级目录到sys.path，打包后的程序无需该操作，修改示例代码：

import sys
import os

# 仅在非打包环境执行路径添加
if not hasattr(sys, 'frozen'):
    sys.path.insert(0, os.path.realpath(os.path.join(os.path.dirname(__file__), "..")))
import numpy as np

if __name__ == "__main__":
    print(np.linspace(0,100,100))

改用pip安装NumPy：Anaconda版本的NumPy存在打包兼容性问题，卸载后用pip重新安装：
```
conda remove numpy
pip install numpy==1.26.4
```
强制包含NumPy包数据：在pysidedeploy.spec的nuitka区块添加--include-package-data=numpy参数，确保NumPy所有必要文件被打包：
```
extra_args = --quiet --noinclude-qt-translations=True --include-package-data=numpy
```