Tkinter按钮无法显示图片 求助故障排查

• 解决PhotoImage被垃圾回收的问题
  tkinter的PhotoImage对象如果是局部变量，会被Python的垃圾回收机制清理，导致按钮无法显示图片。把图片变量绑定到实例或按钮上即可：

  self.photo = PhotoImage(file=r"C:\Users\jim\Pictures\refresh.png")
  self.bt_plot_test1 = tk.Button(self.lf_FileFunctions, image=self.photo, command=self.plot_employee_allocations)
  self.bt_plot_test1.grid(row=3, column=0, padx=0, pady=0, sticky=tk.NW)
  

• 验证图片路径有效性
  检查图片路径是否正确，文件是否存在。可以用以下代码验证：

  import os
  print(os.path.exists(r"C:\Users\jim\Pictures\refresh.png"))
  

  如果输出False，说明路径错误或文件不存在，需要修正路径或确认文件位置。

• 确认图片格式兼容性
  tkinter原生的PhotoImage仅支持GIF、PGM、PPM、PNG（Python 3.4及以上版本）格式。如果你的图片是其他格式（比如JPG），需要使用PIL库的ImageTk.PhotoImage来处理：

  from PIL import Image, ImageTk
  self.photo = ImageTk.PhotoImage(Image.open(r"C:\Users\jim\Pictures\refresh.png"))
  self.bt_plot_test1 = tk.Button(self.lf_FileFunctions, image=self.photo, command=self.plot_employee_allocations)
  self.bt_plot_test1.grid(row=3, column=0, padx=0, pady=0, sticky=tk.NW)
  

  注意需要先安装PIL库：pip install pillow

• 检查按钮配置冲突
  如果按钮同时设置了text和image参数，需要通过compound参数指定图片与文字的位置关系（比如compound=tk.TOP），否则可能导致图片不显示。不过你当前代码未设置text，此点可作为补充排查项。

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