Python Tkinter 图片插入详解：格式支持、PIL处理与内存泄漏修复

Leo

发布时间：2026-10-14| 5人浏览过

原创

本文详解Python Tkinter插入图片的多种方法。针对GIF、PGM/PPM格式，直接使用tkinter.PhotoImage；对于PNG和JPG，需借助PIL库的Image与ImageTk模块。文章重点指出了常见隐患：未保留图片引用导致被垃圾回收而显示空白，以及Spyder环境中反复运行导致的pyimage不存在错误，并提供了保留引用和重启内核的解决方案。

Tkinter原生支持格式与基本用法

在Python Tkinter中，若需插入GIF、PGM或PPM格式的图片，可直接使用tkinter.PhotoImage类进行加载。


import tkinter

class Gui:
  def __init__(self):  
    self.gui=tkinter.Tk()                        # create gui window
    self.gui.title("Image Display")                   # set the title of gui 
    self.gui.geometry("800x600")                    # set the window size of gui 

    img = tkinter.PhotoImage(file="C:/Users/15025/Desktop/bear.gif")  # read image from path

    label1=tkinter.Label(self.gui,image=img)              # create a label to insert this image
    label1.grid()                            # set the label in the main window
 
    self.gui.mainloop()                         # start mainloop

main = Gui()

需要注意的是，在调用tkinter.PhotoImage时，参数file是必须指定的关键字参数，例如img = tkinter.PhotoImage(file="C:/Users/15025/Desktop/bear.gif")。如果省略file关键字，程序将无法正确解析文件路径，从而导致图片无法正常显示。

PIL库处理PNG与JPG格式

对于更为通用的PNG和JPG格式图片，Tkinter原生支持有限，因此需要引入Python Imaging Library（PIL，现多使用其分支Pillow）中的Image和ImageTk模块来完成转换与显示，具体实现代码如下：


import tkinter
from PIL import Image
from PIL import ImageTk


class Gui:
  def __init__(self):  
    self.gui=tkinter.Tk()                # create gui window
    self.gui.title("Image Display")           # set the title of gui 
    self.gui.geometry("800x600")            # set the window size of gui 

    load = Image.open("C:/Users/15025/Desktop/1.png")  # open image from path
    img = ImageTk.PhotoImage(load)           # read opened image

    label1=tkinter.Label(self.gui,image=img)      # create a label to insert this image
    label1.grid()                    # set the label in the main window
 
    self.gui.mainloop()                 # start mainloop

main = Gui()

Spyder环境下的运行错误与解决

在实际开发中，如果使用Anaconda Spyder等集成开发环境，可能会遇到图像显示异常。当代码执行出错后再次运行，常会报出image "pyimage1" doesn't exist错误，且每次重启运行该数字会递增（如pyimage2）。解决此问题的方法是直接在IPython控制台界面重启IPython内核，或者关闭并重新打开编译器。

图片内存泄漏隐患与修复方案

虽然上述方法看似能成功插入图片，但直接编写时存在一个潜在的内存管理隐患，具体代码示例如下：


import tkinter as tk
from PIL import Image
from PIL import ImageTk


class Gui(tk.Tk):
  def __init__(self):
    super().__init__()
    self.title("Figure dynamic show v1.01")
    # self.geometry("1000x800+400+100")
    self.mainGui()
    # self.mainloop()
    

  def mainGui(self):
    image = Image.open("C:/Users/15025/Desktop/1.png")
    photo = ImageTk.PhotoImage(image)
    label = tk.Label(self, image=photo)
    label.image = photo     # in case the image is recycled
    label.grid()
    

main = Gui()
main.mainloop()

对比前例，此处将GUI界面图像插入逻辑封装至独立函数中，并直接继承tkinter类。这种写法允许使用self替代创建的主窗口实例，且mainloop()可在不同位置调用（self.mainloop()或main.mainloop()任选其一）。由于目标是插入图片，可省略固定GUI尺寸设定，从而创建自适应图片大小的窗口。关键改进在于增加了一行代码label.image = photo，即将选取的图片对象photo赋值给label的属性image。若缺失此行，图片将无法显示，原因是Python会自动回收未被引用的局部变量对象，必须通过属性引用保持其存活。前文隐患正是由于缺少这一引用声明所致。

至此，关于Tkinter图片插入的基本方法与常见坑点已介绍完毕。

本文关于Python Tkinter图片插入问题的详解到此结束，更多相关Tkinter图片处理内容可搜索本站往期文章或继续浏览后续教程，感谢支持！