Tkinter自定义窗口类导入后无法渲染全部元素求助

你的问题核心是Tkinter的PhotoImage局部变量被垃圾回收，导致关联的Label和Button控件丢失图片内容，看起来像是控件没渲染出来。

问题原因 #

在scan_code_screen类的window()方法里，background_img和button_image是方法内的局部变量。当window()方法执行完毕，Python会自动回收这些不再被引用的局部变量，而Tkinter的控件并不会主动持有图片对象的引用，所以图片被回收后，控件就显示不出来了。

修复方案 #

把图片变量绑定为类的实例属性（加上self.前缀），让它们的生命周期和窗口实例保持一致，避免被垃圾回收。修改后的窗口类代码如下：

from tkinter import *

base_path = "img/"

def btn_clicked():
    print("Button clicked ")

def center_coordinates(screen_width:int,screen_height:int,width:int,height:int):
    window_x = int((screen_height/2) - (75+(height/2)))
    window_y = int((screen_width/2) - (width/2))    
    return f"{width}x{height}+{window_y}+{window_x}"

class scan_code_screen(Tk):

    def __init__(self):
        Tk.__init__(self)
        self.wm_overrideredirect(False)
        self.geometry(center_coordinates(self.winfo_screenwidth(),self.winfo_screenheight(),550,350))

        self.title(" ")
        self.iconbitmap("img/icon.ico")  # 建议用正斜杠，跨平台更兼容
        self.resizable(False,False)     
              
    def window(self):
        # 将图片变量改为实例属性
        self.background_img = PhotoImage(file=base_path+"background.png")
        bg = Label(self, image=self.background_img).place(x=-2,y=-2)
        
        self.button_image = PhotoImage(file=base_path+"button.png")
        button =Button(self,image=self.button_image,borderwidth=0,highlightthickness=0,command=btn_clicked,relief=FLAT)
        button.place(x=210,y=253)

额外提示 #

• 路径中的反斜杠\在Python里是转义字符，建议统一用正斜杠/，或者用os.path.join(base_path, "icon.ico")拼接路径，避免跨平台问题。
• 如果你不需要单独调用window()方法，也可以把控件创建逻辑直接放到__init__方法里，更符合类的初始化逻辑。

内容的提问来源于stack exchange，提问作者AD0T.dev