使用函数创建Tkinter网格按钮时的图像与点击异常问题

问题根源 #

1. PhotoImage引用被覆盖：你使用全局变量photo存储图像对象，每次调用get_img都会覆盖这个变量，导致之前按钮绑定的图像失去引用，被Python垃圾回收，只有最后一个按钮能保留图像。
2. 尺寸依赖错误：get_img依赖初始按钮btn_1的高度调整图像，但btn_1会被后续按钮覆盖，且未布局完成时获取的尺寸不准确。
3. 冗余按钮布局：初始创建的btn_1被后续按钮重复布局在同一位置，造成不必要的资源浪费。

修复方案 #

核心是给每个按钮单独保留图像引用，避免全局变量覆盖，同时准确获取按钮尺寸调整图像。

修改后的完整代码 #

from tkinter import Tk, Button
from PIL import Image, ImageTk

root = Tk()
# 替换为你的实际图像路径
abs_file_path = "your_image_file.png"

def get_img(target_size):
    """生成指定尺寸的ImageTk.PhotoImage对象"""
    img = Image.open(abs_file_path)
    # 使用LANCZOS采样优化缩放效果
    resize_image = img.resize(target_size, Image.Resampling.LANCZOS)
    return ImageTk.PhotoImage(resize_image)

def new_btn(r, c, btn_id):
    """创建指定行列的按钮，并绑定图像"""
    # 创建按钮，先设置文本作为占位
    btn = Button(root, text=f"Button {btn_id}")
    # 布局按钮
    btn.grid(row=r, column=c, sticky="NESW")
    # 强制更新UI，确保获取准确的按钮尺寸
    root.update_idletasks()
    btn_size = (btn.winfo_width(), btn.winfo_height())
    # 生成图像并绑定到按钮自身属性（关键：保留引用）
    btn_img = get_img(btn_size)
    btn.config(image=btn_img)
    btn.image = btn_img  # 必须保留此引用，防止图像被回收
    return btn

# 创建9*3网格按钮（可扩展为9*9）
button_1 = new_btn(0, 0, "1")
button_2 = new_btn(0, 1, "2")
button_3 = new_btn(0, 2, "3")
button_4 = new_btn(1, 0, "4")
button_5 = new_btn(1, 1, "5")
button_6 = new_btn(1, 2, "6")
button_7 = new_btn(2, 0, "7")
button_8 = new_btn(2, 1, "8")
button_9 = new_btn(2, 2, "9")

root.mainloop()

关键修改说明 #

• 绑定图像引用到按钮：将图像对象赋值给按钮的image属性（btn.image = btn_img），每个按钮独立持有自己的图像引用，避免被垃圾回收。
• 移除全局变量：删除全局的photo、resize_image，避免变量被多次调用覆盖。
• 准确获取按钮尺寸：按钮布局后调用root.update_idletasks()强制UI刷新，确保获取到按钮的实际渲染尺寸，再用来缩放图像。
• 优化图像缩放：使用Image.Resampling.LANCZOS替代默认采样，提升缩放后图像的清晰度。

后续扩展：单独控制按钮图像 #

如果需要仅让特定行列的按钮显示图像，可直接通过按钮对象修改：

# 示例：仅让(1,1)位置的button_5显示图像，其他按钮显示文本
# 更新button_5的图像
btn_size = (button_5.winfo_width(), button_5.winfo_height())
button_5.config(image=get_img(btn_size))
button_5.image = button_5.cget("image")

# 其他按钮隐藏图像，显示文本
button_1.config(image="", text="Button 1")
button_2.config(image="", text="Button 2")
# 以此类推其他按钮

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