PyInstaller打包引用外部py文件的tkinter程序时报错无法执行问题咨询

核心报错原因 #

PyInstaller进行静态依赖分析时，仅会默认扫描主脚本显式关联的标准库、第三方库路径，用户自定义的本地模块如果没有显式声明，不会被自动打包进最终的可执行文件。运行打包后的程序时，找不到依赖的test模块就会触发"Failed to execute script"报错。

场景1：test.py与主脚本test2.py同目录 #

两种解决方法二选一即可：

• 方法1：在打包命令中添加--hidden-import参数，手动声明需要导入的自定义模块

  pyinstaller --onefile --noconsole --hidden-import test test2.py
  

• 方法2：添加-p参数指定当前目录为PyInstaller的模块搜索路径，让工具自动扫描该目录下的所有依赖

  pyinstaller --onefile --noconsole -p ./ test2.py
  

场景2：test.py放在Subfunctions子文件夹中 #

前置调整 #

首先需要将子文件夹标记为Python可识别的包：在Subfunctions目录下新建一个空的__init__.py文件，同时修改test2.py的导入语句：

# 将原有的from test import *替换为下面的语句
from Subfunctions.test import *

打包命令 #

同样二选一即可：

• 方法1：显式声明子目录下的模块为隐藏导入

  pyinstaller --onefile --noconsole --hidden-import Subfunctions.test test2.py
  

• 方法2：指定项目根目录为模块搜索路径

  pyinstaller --onefile --noconsole -p ./ test2.py
  

调试小技巧 #

如果修改后打包仍然报错，可以先去掉--noconsole参数重新打包，运行时会弹出控制台窗口打印完整错误栈，方便快速定位问题。

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