Python Tkinter循环添加图标至按钮失效问题求助

我是Python新手，想用Tkinter动态创建带侧边图标的按钮。预先定义了包含按钮信息的字典列表，通过for循环创建并存储按钮，但遇到问题：循环中为按钮添加图标后，除最后一个按钮外，其余按钮不可点击且不显示图标。

尝试过的代码如下：

按钮信息字典列表：

butlist_sidebar_ld = [
    {"name":"Reports" , "icon":Path(mainpath+imagepath+ "\icon_reports.png") , "link":placeholder},
    {"name":"Stocks" , "icon":Path(mainpath+imagepath+"\icon_stocks.png") , "link":placeholder},
    {"name":"Core Setup" , "icon":Path(mainpath+imagepath+"\icon_settings.png") , "link":placeholder}
]

循环创建按钮的代码：

for button_info in butlist_sidebar_ld:
    # Create a photoimage object
    photo = PhotoImage(file = button_info.get("icon"))
    ph_image = photo.subsample(35,35)

    #Create the button
    button_list[button_info.get("name")] = Button(root,text = button_info.get("name"), compound=LEFT , command= button_info.get("link") , padx = 150 , pady = 30)

    button_list[button_info.get("name")].config(image = ph_image)
    button_list[button_info.get("name")].pack()

也曾尝试直接在Button初始化时传入图片：

for button_info in butlist_sidebar_ld:
    button_list[button_info.get("name")] = Button(
        root,
        text=button_info.get("name"),
        compound=LEFT,
        command=button_info.get("link"),
        padx=150,
        pady=30,
        image=PhotoImage(file=button_info.get("icon")).subsample(35,35)
    )
    button_list[button_info.get("name")].pack()

预期效果是按钮同时显示图标和文本，但实际仅显示文本。调试时加载时间较长偶尔能正常显示，但添加time.sleep(2)无效，希望了解问题所在并获得帮助。

问题根源 #

Tkinter的PhotoImage对象依赖Python的引用计数存活。循环中每次迭代创建的图片对象会被下一次迭代覆盖，导致前几次的PhotoImage失去引用，被Python垃圾回收机制销毁，进而出现图标消失、按钮不可点击的异常。

修复方法 #

需要为每个PhotoImage保留持久引用，两种常用方式：

方法1：将图片绑定到按钮自身属性

把缩放后的图片对象赋值给按钮的自定义属性，确保按钮存在时图片引用不丢失：

button_list = {}  # 先初始化存储按钮的字典

for button_info in butlist_sidebar_ld:
    # 创建并缩放图片
    photo = PhotoImage(file=button_info.get("icon"))
    ph_image = photo.subsample(35, 35)
    
    # 创建按钮
    btn = Button(
        root,
        text=button_info.get("name"),
        compound=LEFT,
        command=button_info.get("link"),
        padx=150,
        pady=30
    )
    # 绑定图片引用到按钮，避免被回收
    btn._icon = ph_image
    btn.config(image=ph_image)
    btn.pack()
    
    button_list[button_info.get("name")] = btn

方法2：用列表统一保存图片引用

创建一个专门的列表存储所有图片对象，保证引用不被销毁：

button_list = {}
image_refs = []  # 保存所有图片引用的列表

for button_info in butlist_sidebar_ld:
    photo = PhotoImage(file=button_info.get("icon"))
    ph_image = photo.subsample(35, 35)
    image_refs.append(ph_image)  # 存入列表保留引用
    
    btn = Button(
        root,
        text=button_info.get("name"),
        compound=LEFT,
        command=button_info.get("link"),
        padx=150,
        pady=30,
        image=ph_image
    )
    btn.pack()
    button_list[button_info.get("name")] = btn

额外注意事项 #

• 确保placeholder函数已正确定义，否则按钮点击会无响应或报错
• 图片路径用Path时建议用/拼接（跨平台兼容），比如Path(mainpath) / imagepath / "icon_reports.png"，避免Windows下的转义问题
• subsample(35,35)缩放比例可能过大，可根据实际图片尺寸调整数值

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