自定义CustomTkinter程序背景图片无法正常显示问题求助

问题根源 #

你的代码里虽给Frame设置了fg_color="transparent"，但存在两个关键问题导致背景被遮挡：

• 背景Label的层级调整时机错误：需在所有Frame创建完成后再将背景置于底层，才能确保它在所有Frame下方
• 部分CustomTkinter版本中，仅设置Frame的fg_color透明不够，还需同步设置bg_color保证背景穿透

修复步骤 #

1. 调整背景Label的层级位置 #

将self.background_label.lower()移到所有Frame创建完成后、显示初始Frame之前：

# 创建完所有Frame、调试菜单后执行
self.background_label.lower()  # 确保背景在所有Frame之后被置于底层
self.show_frame('Login')

原因：先创建所有Frame再调整背景层级，能保证Frame都在背景之上，同时避免grid布局的Frame覆盖place布局的背景Label。

2. 完善Frame的透明设置 #

在add_frame方法中，同时设置fg_color和bg_color为透明：

def add_frame(self, page_class, name):
    frame = page_class(self)
    frame.configure(fg_color="transparent", bg_color="transparent")  # 补充bg_color设置
    self.frames[name] = frame
    frame.grid(row=0, column=0, sticky='nsew')

3. 验证图片路径正确性 #

确保"EquipmentManager\\background.png"路径有效：

• 若用相对路径，确认脚本运行的工作目录包含目标文件夹
• 可临时改用绝对路径测试，比如：

self.background_image = ctk.CTkImage(Image.open(r"C:\YourProjectPath\EquipmentManager\background.png"), size=(1000, 580))

4. 确保调试菜单层级（可选） #

如果调试菜单被Frame遮挡，手动将其置于顶层：

if self.debug_mode:
    self.frame_selector = ctk.CTkOptionMenu(
        self,
        values=list(self.frames.keys()),
        command=self.show_frame,
    )
    self.frame_selector.grid(row=0, column=1, padx=10, pady=10, sticky='e')
    self.frame_selector.tkraise()  # 强制调试菜单在最上层

修复后的关键代码片段 #

class FrameManager(ctk.CTk):
    def __init__(self, debug_mode=False):
        super().__init__()

        self.title('Equipment Manager')
        self.geometry('1000x580')
    
        # Add background image
        self.background_image = ctk.CTkImage(Image.open("EquipmentManager\\background.png"), size=(1000, 580))
        self.background_label = ctk.CTkLabel(self, image=self.background_image, text="")
        self.background_label.place(x=0, y=0, relwidth=1, relheight=1)
    
        # Configure layout grid
        self.grid_rowconfigure(0, weight=1)
        self.grid_columnconfigure(0, weight=1)
    
        # Create a dictionary for frames
        self.frames = {}
    
        # Add all the frames
        self.add_frame(LoginFrame, 'Login')
        self.add_frame(SignUpFrame, 'Sign Up')
        self.add_frame(LoadingFrame, 'Loading')
        self.add_frame(DatabaseFrame, 'Database')
        self.add_frame(ViewContactData, 'CData')
        self.add_frame(ViewEquipmentData, 'EData')
        self.add_frame(AddContact, 'AddC')
        self.add_frame(AddEquipment, 'AddE')
    
        # Debug mode
        self.debug_mode = debug_mode
        if self.debug_mode:
            self.frame_selector = ctk.CTkOptionMenu(
                self,
                values=list(self.frames.keys()),
                command=self.show_frame,
            )
            self.frame_selector.grid(row=0, column=1, padx=10, pady=10, sticky='e')
            self.frame_selector.tkraise()
    
        # 调整背景层级到所有Frame之后
        self.background_label.lower()
        # Show the first frame
        self.show_frame('Login')
    
    def add_frame(self, page_class, name):
        # Add frames and set transparency
        frame = page_class(self)
        frame.configure(fg_color="transparent", bg_color="transparent")  # 补充bg_color设置
        self.frames[name] = frame
        frame.grid(row=0, column=0, sticky='nsew')

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