PyInstaller编译的macOS单文件窗口应用闪退重启问题求助

使用PyInstaller将带有Tkinter GUI的Python脚本编译为macOS应用时，采用--onefile --windowed参数编译的程序会在Dock短暂显示后闪退，等待10-20秒后自动重启并正常运行；但使用--onedir --windowed参数编译则可直接正常启动。偏好单文件窗口模式，尝试多种参数未解决该问题。

环境配置 #

• macOS Ventura 13.1
• Python 3.9.18
• PyInstaller 6.0.0
• pyinstaller-hooks-contrib 2023.9

原编译命令（onedir版本） #

python -m PyInstaller --noconfirm --noconsole --onedir --clean --icon "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/favicon.icns" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/env/lib/python3.9/site-packages/iso639:iso639/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/templates:templates/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/static:static/" main.py

1. 延迟Tkinter初始化 #

单文件模式下，PyInstaller需要先解压临时文件，提前初始化Tkinter会引发闪退。在脚本开头添加延迟，确保临时文件解压完成后再启动GUI：

import sys
import time
import tkinter as tk

# 针对单文件打包的延迟处理
if getattr(sys, 'frozen', False):
    # 根据实际情况调整延迟时长，确保临时文件解压完成
    time.sleep(2)

# 后续Tkinter初始化逻辑
root = tk.Tk()
root.mainloop()

2. 指定自定义临时目录 #

默认临时目录可能存在权限或解压速度问题，手动指定用户可读写的临时目录：

python -m PyInstaller --noconfirm --noconsole --onefile --clean --icon "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/favicon.icns" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/env/lib/python3.9/site-packages/iso639:iso639/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/templates:templates/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/static:static/" --runtime-tmpdir "${HOME}/.tmp/overtitle" main.py

替换overtitle为你的应用名称，确保该目录可被PyInstaller自动创建。

3. 禁用进程隔离 #

添加--no-process-isolation参数，避免单文件模式下的进程隔离导致Tkinter初始化异常：

python -m PyInstaller --noconfirm --noconsole --onefile --clean --no-process-isolation --icon "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/favicon.icns" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/env/lib/python3.9/site-packages/iso639:iso639/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/templates:templates/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/static:static/" main.py

4. 检查并补全Tkinter依赖 #

通过调试日志确认Tkinter相关文件是否被正确打包，若缺失则手动添加隐式导入：

# 生成调试日志
python -m PyInstaller --noconfirm --noconsole --onefile --clean --debug all --icon "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/favicon.icns" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/env/lib/python3.9/site-packages/iso639:iso639/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/templates:templates/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/static:static/" main.py

# 若日志显示Tkinter依赖缺失，添加隐式导入参数重新编译
python -m PyInstaller --noconfirm --noconsole --onefile --clean --hidden-import tkinter --hidden-import tkinter.ttk --icon "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/favicon.icns" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/env/lib/python3.9/site-packages/iso639:iso639/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/templates:templates/" --add-data "/Users/ugn/Documents/Code/Commercial/overtitle/overtitle-build/static:static/" main.py

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