用PyInstaller打包的Tkinter可执行文件在Win10正常，Win11无法运行

排查与修复步骤 #

1. 强制捕获异常日志 #

即使命令行运行无报错，也可能是GUI初始化阶段触发异常但未输出。给主程序添加全局异常捕获，将错误写入本地日志：

import sys
import traceback
import tkinter as tk

def main():
    root = tk.Tk()
    # 你的GUI业务代码
    root.mainloop()

if __name__ == "__main__":
    try:
        main()
    except Exception as e:
        with open("error_log.txt", "w", encoding="utf-8") as f:
            f.write(f"错误类型: {type(e).__name__}\n")
            f.write(f"错误信息: {str(e)}\n")
            f.write("调用栈详情:\n")
            f.write(traceback.format_exc())
        input(f"程序异常退出，日志已保存至 error_log.txt，按回车关闭")

重新打包后在Win11运行，查看error_log.txt即可定位具体问题。

2. 确保Tkinter依赖完整收集 #

Win11的Tkinter依赖组件可能与Win10存在差异，打包时强制收集所有Tkinter相关文件：

• 单文件打包命令：

pyinstaller --onefile --collect-all tkinter your_script.py

• 尝试文件夹模式打包（避免单文件解压路径问题）：

pyinstaller --collect-all tkinter your_script.py

3. 适配Win11高DPI设置 #

Win11的高DPI缩放可能导致Tkinter初始化失败，在程序开头添加适配代码：

import ctypes
try:
    ctypes.windll.shcore.SetProcessDpiAwareness(1)
except:
    pass

也可右键点击打包后的exe，在「属性-兼容性-高DPI缩放替代」中选择「系统（增强）」。

4. 检查Python版本兼容性 #

避免使用过新的Python版本（如3.12），PyInstaller对新版本的适配可能滞后，建议用3.9-3.11这类稳定版本重新打包。

5. 跨系统打包验证 #

如果之前是在Win10环境打包，换到Win11系统重新打包，消除跨系统依赖差异。

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