Tkinter按钮图片无法显示问题排查及解决方案求助

问题核心原因 #

你的代码存在两个关键问题：

1. pack()返回值覆盖按钮对象：Button(...).pack()会把pack()的返回值（None）赋值给self.fillButton，导致它不再是有效的按钮实例，后续操作会报错。
2. 手动固定尺寸挤压图片：设置width=40, height=40可能和图片实际尺寸不匹配，导致图片无法正常显示，甚至按钮被压缩成极小状态。

可行修复方案 #

方案1：拆分按钮创建与布局语句

将按钮实例化和布局操作分开，确保self.fillButton指向真实的按钮对象：

from tkinter import *

class App():
    def __init__(self):
        self.root = Tk()
        self.root.resizable(False, False)

        # 保存图片引用，避免被垃圾回收
        self.fill_bucket_photo = PhotoImage(file='./img/fill_bucket.png')

        # 先创建按钮实例，再调用pack布局
        self.fillButton = Button(self.root, image=self.fill_bucket_photo, compound='top', font=('Arial', 25))
        self.fillButton.pack()

        self.root.mainloop()
        
app = App()

方案2：调整图片尺寸（如果图片过大）

如果原图尺寸超出按钮可显示范围，可通过subsample()或zoom()缩放图片：

# 缩小为原尺寸的1/2（参数为缩放分母，数值越大图片越小）
self.fill_bucket_photo = PhotoImage(file='./img/fill_bucket.png').subsample(2, 2)

方案3：验证图片路径正确性

使用绝对路径确认图片可被读取，避免相对路径的环境问题：

import os
# 获取图片绝对路径
img_path = os.path.join(os.path.dirname(__file__), 'img', 'fill_bucket.png')
self.fill_bucket_photo = PhotoImage(file=img_path)

方案4：移除不必要的尺寸参数

如果不需要固定按钮大小，删除width和height参数，让按钮自动适配图片尺寸，这是最稳妥的方式。

补充说明 #

你之前尝试的label.image = photo方案，核心是保存图片引用避免垃圾回收，但你已经将图片赋值给self.fill_bucket_photo，只要类实例存在，图片就不会被回收，所以这个问题你已经解决了。Button本身没有image属性，这就是你触发AttributeError的原因，无需给按钮额外添加该属性。

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