使用PyInstaller打包customtkinter番茄钟exe遇模块缺失错误求助

一、解决--onefile模式下ModuleNotFoundError #

1. 更新依赖到最新版本
   激活你的虚拟环境，执行命令确保PyInstaller和CustomTkinter为最新版，避免版本兼容问题：

   pip install --upgrade pyinstaller customtkinter
   

2. 使用--collect-all参数打包
   用--collect-all收集CustomTkinter的所有文件（含子模块、资源文件），比单独--hidden-import覆盖更彻底：

   pyinstaller --onefile --collect-all customtkinter main.py
   

   若项目用到win10toast，补充对应收集参数：

   pyinstaller --onefile --collect-all customtkinter --collect-all win10toast main.py
   

3. 手动编辑spec文件（进阶方案）
   若上述命令无效，生成并修改spec文件精准控制打包内容：

   • 生成spec文件：

     pyinstaller --name TomatoTimer main.py
     

   • 打开TomatoTimer.spec，在开头导入收集工具，替换Analysis部分内容：

     from PyInstaller.utils.hooks import collect_all
     
     # 收集CustomTkinter的资源与依赖
     ct_datas, ct_binaries, ct_hidden = collect_all('customtkinter')
     # 若用到win10toast，同步收集
     toast_datas, toast_binaries, toast_hidden = collect_all('win10toast')
     
     a = Analysis(
         ['main.py'],
         pathex=[],
         binaries=ct_binaries + toast_binaries,
         datas=ct_datas + toast_datas,
         hiddenimports=ct_hidden + toast_hidden,
         # 保留原有其他参数
     )
     

   • 用spec文件打包：

     pyinstaller --onefile TomatoTimer.spec
     

二、解决无--onefile模式下闪退问题 #

闪退核心是看不到报错信息，按以下步骤排查：

1. 通过命令行运行exe
   打开命令提示符（CMD），切换到打包后的dist文件夹路径，直接执行exe：

   cd dist\main  # 替换为你的打包文件夹名称
   main.exe
   

   此时会显示具体错误（如缺少依赖、资源文件丢失），针对性修复。

2. 检查资源文件打包
   若番茄钟用到图标、配置文件等本地资源，需在打包时指定路径。例如在spec文件的datas中添加：

   datas=[('assets/icon.ico', 'assets'), ('config.ini', '.')]
   

   格式说明：(本地文件路径, 打包后存放的相对路径)

三、额外排查点 #

• 确保虚拟环境仅包含项目必需依赖，避免冗余包干扰打包。
• Windows系统打包时暂时关闭杀毒软件，防止文件被拦截。
• 测试exe优先通过CMD运行，方便查看报错日志。

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