实现Tkinter闪屏(Splash Screen)时报错pyimage不存在该如何解决

问题根源 #

你的错误是由同时创建了多个tk.Tk()根窗口实例导致的：

• 每个tk.Tk()都会初始化独立的Tcl解释器上下文，不同上下文之间的资源（包括PhotoImage图片对象、控件ID等）完全不互通
• 你先创建了闪屏的splash_root = tk.Tk()，此时所有ImageTk.PhotoImage默认会绑定到这个根窗口上下文
• 导入main_file后你销毁了splash_root，对应的图片资源也被同步释放，而main_file里的主窗口是第二个独立的tk.Tk()实例，自然找不到已经被释放的图片ID，就抛出pyimageXX doesn't exist的错误

解决方法 #

有三种常用的解决方案，按优先级推荐如下：

方案1：全程只保留一个tk.Tk()根实例，闪屏用Toplevel子窗口实现 #

这是tkinter官方推荐的最佳实践，避免多上下文冲突：

1. 整个程序只创建一个全局的tk.Tk()作为根实例
2. 闪屏作为根实例的Toplevel子窗口实现，闪屏展示阶段隐藏根窗口，闪屏销毁后再显示根窗口
3. 主窗口所有控件和资源都绑定到全局唯一的根实例上

示例启动代码：

import tkinter as tk

# 唯一全局根窗口，先隐藏
root = tk.Tk()
root.withdraw()

# 闪屏用Toplevel实现
splash_window = tk.Toplevel(root)
splash_window.geometry("200x200")
# 去掉闪屏窗口的标题栏可选
splash_window.overrideredirect(True)
tk.Label(splash_window, text="Splash Screen", font=18).pack()

# 闪屏2秒后销毁，显示主窗口
def close_splash():
    splash_window.destroy()
    root.deiconify()
splash_window.after(2000, close_splash)

# 主窗口初始化绑定到root
# 建议把main_file里的主窗口初始化逻辑封装为函数，不要导入时直接执行
import main_file
main_file.init_main(root)

tk.mainloop()

方案2：给PhotoImage显式指定master参数 #

如果你确实需要保留多根窗口结构，创建图片时显式指定要绑定的主窗口实例，避免默认绑定到第一个创建的根窗口：

# self是主窗口实例的话直接传self即可
self.plus_render = ImageTk.PhotoImage(
    self.image_package_render.resize((14, 14), box=(16, 20, 30, 34)),
    master=self
)

方案3：闪屏完全销毁后再加载主窗口的图片资源 #

调整代码执行顺序，确保销毁splash_root之后，再执行main_file里的图片加载、窗口初始化逻辑，避免图片被绑定到闪屏的上下文。

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