Tkinter中‘image pyimageXX does not exist’错误原因及简易修复方法

问题出在哪 #

• Tkinter设计上只允许一个Tk()主窗口实例，你在主菜单和子窗口里各创建了一个Tk()，两者的资源上下文完全独立，导致子窗口的图片无法被正确识别，触发报错。
• 另外，PhotoImage对象如果没有被持续引用，会被Python的垃圾回收机制清理，也会导致图片消失。

简单修复步骤 #

1. 用Toplevel()替代子窗口的Tk()

所有非主窗口都用Toplevel()创建，它依附于主窗口，共享同一资源上下文，从根本上解决跨实例的资源冲突。

2. 给PhotoImage留个“引用”

把图片对象绑定到按钮的属性上，避免被垃圾回收。

修改后的代码 #

file_example1.py

from tkinter import *

def buttonFunc1(parent):
    # 用Toplevel创建子窗口，传入主窗口作为父组件
    root = Toplevel(parent)
    root.geometry("800x500")

    imageInstance = PhotoImage(file="path/to/image/file")
    button = Button(root, image=imageInstance, border=0)
    # 将图片绑定到按钮属性，保留引用
    button.image = imageInstance
    button.pack()

if __name__ == '__main__':
    # 单独运行时创建主窗口
    main_root = Tk()
    buttonFunc1(main_root)
    main_root.mainloop()

主菜单文件

from tkinter import *
from file_example1 import buttonFunc1

# 只创建一个主窗口实例
menu = Tk()
menu.geometry('800x500')

imageInstance2 = PhotoImage(file="path/to/another/image/file")
button_to_another_window = Button(
    menu, 
    image=imageInstance2, 
    border=0, 
    # 用lambda把主窗口传给子窗口函数
    command=lambda: buttonFunc1(menu)
)
# 保留图片引用
button_to_another_window.image = imageInstance2
button_to_another_window.pack()

menu.mainloop()

为什么这样改 #

• Toplevel()作为子窗口，和主窗口共享资源池，图片不会因为跨实例而找不到。
• 绑定图片到按钮属性是最简洁的持久化方式，不用额外写全局变量或者类，适合你的需求。

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