Tkinter类与框架开发中出现‘pyimage2不存在’错误求助

报错信息 #

Traceback (most recent call last):
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\tkinter\__init__.py", line 1921, in __call__
    return self.func(*args)
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\venv\lib\site-packages\customtkinter\windows\widgets\ctk_button.py", line 549, in _clicked
    self._command()
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\input_frame.py", line 88, in go_back
    from main import SerialFrame
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\main.py", line 126, in <module>
    SerialFrame(root).place(x=25, y=50)
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\main.py", line 20, in __init__
    self.createWidgetsMain()
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\main.py", line 101, in createWidgetsMain
    refresh_serials = customtkinter.CTkButton(master=self, command=refresh_menu, image=my_image, width=20,
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\venv\lib\site-packages\customtkinter\windows\widgets\ctk_button.py", line 106, in __init__
    self._draw()
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\venv\lib\site-packages\customtkinter\windows\widgets\ctk_button.py", line 261, in _draw
    self._update_image()  # set image
  File "D:\PYCHARM\pycharmprojects\lumacol_frontend\venv\lib\site-packages\customtkinter\windows\widgets\ctk_button.py", line 172, in _update_image
    self._image_label.configure(image=self._image.create_scaled_photo_image(self._get_widget_scaling(),
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\tkinter\__init__.py", line 1675, in configure
    return self._configure('configure', cnf, kw)
  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.2544.0_x64__qbz5n2kfra8p0\lib\tkinter\__init__.py", line 1665, in _configure
    self.tk.call(_flatten((self._w, cmd)) + self._options(cnf))
_tkinter.TclError: image "pyimage2" doesn't exist

应用场景与代码结构 #

• 主文件main.py定义SerialFrame（继承自customtkinter.CTkFrame），初始化主窗口root并创建SerialFrame实例显示。
• 另外两个文件分别定义InputFrame、MenuFrame功能框架。
• 切换逻辑：通过SerialFrame的分段按钮销毁当前框架，创建对应功能框架；点击功能框架的"Go Back"按钮时，执行go_back函数销毁当前框架，重新导入SerialFrame并创建实例，此时触发上述错误。
• SerialFrame中创建带图片按钮的代码：

my_image = customtkinter.CTkImage(light_image=Image.open("images/refresh.png"),
                                  dark_image=Image.open("images/refresh.png"),
                                  size=(20, 20))

# CREATE REFRESH BUTTON
refresh_serials = customtkinter.CTkButton(master=self, command=refresh_menu, image=my_image, width=20,
                                          text="")

问题分析 #

1. 模块重复初始化：go_back函数中执行from main import SerialFrame时，main.py的顶层代码（包括SerialFrame(root).place(...)）会被再次执行，导致重复创建实例，引发Tcl解释器的图片对象上下文冲突。
2. 循环导入与代码执行时机错误：main与InputFrame模块互相导入，且main的实例化代码未放在if __name__ == "__main__":保护块中，导致import时自动执行实例创建逻辑。
3. 图片对象引用丢失：my_image是局部变量，函数执行完毕后可能被垃圾回收，导致Tkinter无法找到对应图片资源。

解决方案 #

1. 修复模块执行时机，避免重复初始化 #

修改main.py，将实例化代码放入if __name__ == "__main__":块，确保其他模块import时不会自动创建实例：

# main.py
import customtkinter
from input_frame import InputFrame
from menu_frame import MenuFrame

class SerialFrame(customtkinter.CTkFrame):
    # ... 你的类定义 ...

if __name__ == "__main__":
    root = customtkinter.CTk()
    # ... 设置root属性 ...
    SerialFrame(root).place(x=25, y=50)
    root.mainloop()

2. 避免循环导入，传递类引用 #

创建InputFrame时直接传递SerialFrame类引用，无需在go_back中重新import：

# main.py中切换到InputFrame的逻辑
def switch_to_input_frame(self):
    self.destroy()
    # 传递SerialFrame类给InputFrame
    InputFrame(self.master, serial_frame_class=SerialFrame).place(x=25, y=50)

# input_frame.py
class InputFrame(customtkinter.CTkFrame):
    def __init__(self, master, serial_frame_class, **kwargs):
        super().__init__(master, **kwargs)
        self.serial_frame_class = serial_frame_class
        # ... 其他初始化代码 ...
        self.back_btn = customtkinter.CTkButton(self, text="Go Back", command=self.go_back)
        self.back_btn.pack()
    
    def go_back(self):
        self.destroy()
        # 使用保存的类创建实例
        self.serial_frame_class(self.master).place(x=25, y=50)

3. 保持图片对象的持久引用 #

将my_image定义为SerialFrame的实例属性，防止被垃圾回收：

# SerialFrame的createWidgetsMain方法中
self.my_image = customtkinter.CTkImage(
    light_image=Image.open("images/refresh.png"),
    dark_image=Image.open("images/refresh.png"),
    size=(20, 20)
)

# 创建按钮时使用实例属性
refresh_serials = customtkinter.CTkButton(
    master=self, 
    command=refresh_menu, 
    image=self.my_image, 
    width=20,
    text=""
)

4. 可选优化：统一框架切换逻辑 #

创建框架管理器类，集中处理框架生命周期：

# frame_manager.py
class FrameManager:
    def __init__(self, root):
        self.root = root
        self.current_frame = None
    
    def switch_frame(self, frame_class, **kwargs):
        if self.current_frame:
            self.current_frame.destroy()
        self.current_frame = frame_class(self.root, **kwargs)
        self.current_frame.place(x=25, y=50)

# main.py中初始化管理器
if __name__ == "__main__":
    root = customtkinter.CTk()
    root.manager = FrameManager(root)
    root.manager.switch_frame(SerialFrame)
    root.mainloop()

# InputFrame中切换框架
def go_back(self):
    self.master.manager.switch_frame(SerialFrame)

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