如何在PyInstaller打包的Tkinter应用已运行时跳过启动闪屏？

核心原因 #

PyInstaller的闪屏由其引导加载器（bootloader）在你的Python代码执行前就触发显示，你的instance_check函数是在闪屏出现后才运行的，所以即使检测到已有实例，闪屏还是会先弹出。

解决方案1：拆分程序为前置检测脚本+主程序 #

把单实例检测逻辑单独做成启动脚本，只有检测通过才启动带闪屏的主程序：

1. 编写前置检测脚本（launcher.py）

import ctypes
import sys
import subprocess
import os

APP_NAME = "你的应用窗口标题"
MAIN_APP_EXE = "main_app.exe"  # 主程序打包后的文件名

def instance_check() -> bool:
    user32 = ctypes.WinDLL('user32')
    if hwnd := user32.FindWindowW(None, APP_NAME):
        if not user32.IsZoomed(hwnd):
            user32.ShowWindow(hwnd, 1)
        user32.SetForegroundWindow(hwnd)
        return False
    return True

if __name__ == '__main__':
    if instance_check():
        # 定位同目录下的主程序
        exe_path = os.path.join(os.path.dirname(sys.executable), MAIN_APP_EXE)
        subprocess.Popen([exe_path])
    sys.exit()

2. 打包主程序（保留闪屏）
   用PyInstaller打包你的Tkinter主程序，保留闪屏配置：

pyinstaller --onefile --windowed --splash splash.png main_app.py

3. 打包前置检测脚本（无闪屏）
   打包启动脚本时禁用控制台和闪屏：

pyinstaller --onefile --noconsole launcher.py

4. 使用方式
   用户只需运行launcher.exe，它会先完成单实例检测，仅在无运行实例时才启动带闪屏的主程序，完全避免多余闪屏。

解决方案2：修改PyInstaller的.spec文件（进阶） #

通过自定义.spec文件，让引导加载器在显示闪屏前先执行单实例检测：

1. 生成默认.spec文件：

pyinstaller --splash splash.png your_app.py

2. 编辑.spec文件，在开头插入检测逻辑：
   在原.spec内容前添加检测代码，确保闪屏加载前完成实例校验：

import ctypes
import sys

APP_NAME = "你的应用窗口标题"

def instance_check():
    user32 = ctypes.WinDLL('user32')
    if hwnd := user32.FindWindowW(None, APP_NAME):
        if not user32.IsZoomed(hwnd):
            user32.ShowWindow(hwnd, 1)
        user32.SetForegroundWindow(hwnd)
        sys.exit()

# 先执行实例检测
instance_check()

# 原.spec文件的内容
a = Analysis(
    ['your_app.py'],
    # ... 原配置内容
)
pyz = PYZ(a.pure, a.zipped_data)
splash = Splash('splash.png',
                # ... 原闪屏配置
                )
exe = EXE(
    pyz,
    a.scripts,
    splash,
    # ... 原EXE配置
)

3. 用修改后的.spec文件打包：

pyinstaller your_app.spec

这种方式无需拆分程序，直接在打包配置里前置检测逻辑，让闪屏仅在必要时显示。

注意事项 #

• 确保APP_NAME与你的Tkinter窗口标题完全一致，否则FindWindowW无法定位已有实例。
• 方案1更简单易维护，适合大多数场景；方案2适合不想拆分程序的进阶用户。

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