PyInstaller打包程序关闭时提示Failed to execute script错误如何解决

该报错是无控制台模式下程序退出阶段抛出未捕获异常导致的：你使用的-w参数会隐藏控制台窗口，只要程序生命周期内（包括退出逻辑）存在未处理的异常，关闭时就会触发该弹窗，运行阶段无报错说明异常仅发生在资源销毁/退出流程中。

1. 定位具体异常（必做步骤） #

先去掉-w参数打包一次，运行程序后正常关闭，控制台会输出完整报错栈，可直接定位到出错的代码行，这是最高效的排查方式：

pyinstaller --onefile script.py

2. pygame场景通用修复 #

大部分pygame打包关闭报错都是退出时未正确清理资源导致的，按以下逻辑修改退出代码：

• 退出前先调用pygame.quit()释放所有pygame占用的资源
• 不要直接调用sys.exit()，先处理完所有pygame事件队列再退出
  示例退出逻辑：

import sys
import pygame

# 主循环示例
running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

# 退出前按顺序清理
pygame.quit()
sys.exit()

3. tkinter场景通用修复 #

tkinter关闭报错大多是销毁窗口顺序错误、后台线程未正确终止导致的：

• 不要直接调用os._exit()强制退出，优先用root.destroy()销毁主窗口后自然退出
• 如果存在后台线程，将其设置为守护线程，或者退出前主动终止线程再销毁窗口
  示例退出逻辑：

import tkinter as tk

root = tk.Tk()

def on_closing():
    # 此处添加自定义资源清理逻辑，比如关闭文件、终止线程
    root.destroy()

root.protocol("WM_DELETE_WINDOW", on_closing)
root.mainloop()

4. 打包参数调整 #

如果确认退出逻辑无问题仍报错，可调整打包参数规避：

• 增加--noupx参数禁用UPX压缩，部分UPX压缩版本会导致资源释放异常
• 若不需要单文件打包，去掉--onefile参数使用文件夹模式打包，减少资源加载释放的冲突
  最终打包命令示例：

pyinstaller -w --onefile --noupx script.py

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