CustomTkinter多窗口图片加载失败：pyimage不存在错误求助

核心原因 #

这个错误源于CustomTkinter（底层基于tkinter）的图像绑定机制：

• CTkImage本质依赖tkinter的PhotoImage，这类图像对象必须与创建它的根窗口实例绑定，生命周期和窗口完全挂钩。
• 如果你创建了两个独立的CTk子类实例（即两个根窗口），且images.py中的CTkImage是在模块级别提前初始化的，它会默认绑定到第一个创建的根窗口。当第二个窗口（欢迎页）尝试使用该图像时，若第一个窗口已销毁或图像上下文未关联到当前窗口，就会触发image "pyimageXX" doesn't exist错误。

解决办法 #

1. 统一使用单一根窗口，页面以CTkFrame形式嵌入（推荐） #

不要创建多个CTk子类窗口，而是将主界面和欢迎页都作为CTkFrame，挂载到同一个CTk根窗口下。这样所有图像对象都绑定到同一个根窗口，彻底避免上下文冲突：

import customtkinter as ctk
from PIL import Image

# 定义页面为CTkFrame
class WelcomePage(ctk.CTkFrame):
    def __init__(self, parent):
        super().__init__(parent)
        # 在当前Frame上下文下创建CTkImage，master指定为self
        self.welcome_img = ctk.CTkImage(light_image=Image.open("images/welcome.png"), size=(200,200), master=self)
        ctk.CTkLabel(self, image=self.welcome_img, text="").pack(pady=20)

class MainInterface(ctk.CTkFrame):
    def __init__(self, parent):
        super().__init__(parent)
        self.main_img = ctk.CTkImage(light_image=Image.open("images/main.png"), size=(200,200), master=self)
        ctk.CTkLabel(self, image=self.main_img, text="").pack(pady=20)

# 单一根窗口管理页面切换
class App(ctk.CTk):
    def __init__(self):
        super().__init__()
        self.welcome_page = WelcomePage(self)
        self.main_page = MainInterface(self)
        
        # 默认显示欢迎页
        self.welcome_page.pack(fill="both", expand=True)
        
        # 示例切换按钮
        ctk.CTkButton(self.welcome_page, text="进入主界面", command=self.show_main_page).pack(pady=10)
        ctk.CTkButton(self.main_page, text="返回欢迎页", command=self.show_welcome_page).pack(pady=10)
    
    def show_main_page(self):
        self.welcome_page.pack_forget()
        self.main_page.pack(fill="both", expand=True)
    
    def show_welcome_page(self):
        self.main_page.pack_forget()
        self.welcome_page.pack(fill="both", expand=True)

if __name__ == "__main__":
    app = App()
    app.mainloop()

2. 延迟初始化图像，绑定到当前窗口实例 #

如果必须保留两个独立CTk窗口，不要在images.py模块级别提前创建CTkImage，而是改为函数形式，在每个窗口内部创建时指定master为当前窗口：

# images.py
import customtkinter as ctk
from PIL import Image

def get_welcome_img(master):
    return ctk.CTkImage(light_image=Image.open("images/welcome.png"), size=(200,200), master=master)

def get_main_img(master):
    return ctk.CTkImage(light_image=Image.open("images/main.png"), size=(200,200), master=master)

# 主界面窗口
class UserInterface(ctk.CTk):
    def __init__(self):
        super().__init__()
        self.main_img = get_main_img(self)  # 绑定到当前主窗口
        ctk.CTkLabel(self, image=self.main_img, text="").pack()

# 欢迎页窗口
class Welcomepage(ctk.CTk):
    def __init__(self):
        super().__init__()
        self.welcome_img = get_welcome_img(self)  # 绑定到当前欢迎页窗口
        ctk.CTkLabel(self, image=self.welcome_img, text="").pack()

3. 避免窗口销毁导致图像失效 #

如果存在窗口切换销毁的场景，确保图像对象在窗口创建时重新初始化，不要复用已绑定到销毁窗口的图像实例。

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