PyInstaller打包Tkinter程序报错No module named 'paddle'如何解决

问题根因 #

1. 命令语法错误：Windows cmd 不支持单引号作为路径包裹符，你之前使用的单引号导致--paths参数完全失效，从打包日志的PYTHONPATH记录可以看到，虚拟环境site-packages路径被错误拼接成了当前工作目录的子路径，PyInstaller没有正确读取到虚拟环境的依赖库。
2. 依赖扫描不全：Paddlepaddle包含大量动态链接库、protobuf定义和隐性依赖，仅靠--hidden-import参数无法覆盖全部依赖项，PyInstaller默认扫描逻辑会遗漏大量Paddle运行必需的文件。

解决步骤 #

1. 清理历史打包缓存 #

在当前项目目录下执行以下命令删除之前的打包产物：

rd /s /q build dist
del /f gui.spec

2. 执行修正后的打包命令 #

Windows cmd 下使用双引号包裹路径，同时补全Paddle相关的隐性导入和动态库文件：

pyinstaller --onefile --clean ^
--paths "C:\Users\user\anaconda3\envs\py38\Lib\site-packages" ^
--hidden-import paddle ^
--hidden-import paddle.fluid ^
--hidden-import paddle.fluid.proto ^
--hidden-import paddle.dataset ^
--hidden-import paddle.utils ^
--add-data "C:\Users\user\anaconda3\envs\py38\Lib\site-packages\paddle\*.dll;./paddle" ^
--add-data "C:\Users\user\anaconda3\envs\py38\Lib\site-packages\paddle\libs\*.dll;./paddle/libs" ^
gui.py

如果你的GUI程序不需要弹出控制台窗口，可以在命令末尾追加--windowed参数。

3. 调试验证 #

如果打包后仍然报错，先将--onefile替换为--onedir生成文件夹版产物，进入dist/gui目录后在cmd中手动执行gui.exe，可以看到完整的错误提示，根据提示补全缺失的依赖即可。

内容的提问来源于stack exchange，提问作者user3708629