使用pyside6-deploy打包Windows11 Python应用时numpy导入报错求助

安全阿岳

2026-7-2

解决pyside6-deploy打包Qt+Pandas应用时的numpy导入错误

错误原因分析

这个numpy导入错误本质是打包过程中，工具误将numpy的源码目录（或不完整的安装目录）纳入了打包范围，导致运行时程序误以为在numpy源码目录中执行，触发了numpy的路径校验机制。

确认numpy安装状态
先检查numpy是否为正常的二进制安装包，而非源码目录：
```
pip show numpy
```
确保Location指向Python环境的site-packages/numpy，如果是源码安装的，卸载后重装二进制包：
```
pip uninstall numpy -y
pip install numpy
```
明确依赖清单
创建requirements.txt文件，明确列出所有依赖，帮助打包工具准确识别：
```
pandas>=2.0.0
PySide6>=6.5.0
numpy>=1.24.0
```
执行安装命令确保依赖统一：
```
pip install -r requirements.txt
```
调整打包参数
打包时手动指定需要包含的依赖包，同时排除numpy的源码目录（如果存在）：
```
pyside6-deploy your_app.py --include-packages numpy,pandas --exclude-dir numpy/src
```
若打包生成了.spec文件，可打开检查其中的pathex和includes配置，确保numpy的路径指向site-packages中的正确目录。
清理缓存后重新打包
删除打包生成的build和dist目录，清空工具缓存，再重新执行打包命令，避免旧缓存导致的路径错误。
使用虚拟环境隔离依赖
创建独立虚拟环境，避免全局环境的依赖冲突：
```
python -m venv venv
venv\Scripts\activate
pip install pandas PySide6 pyside6-deploy
```
在虚拟环境中完成打包操作，能最大程度减少环境变量或杂项依赖的干扰。