如何在Tkinter中完整显示图片？已尝试多种方法无效

问题描述 #

尝试了多种方法（代码中已注释的行），仍无法在Tkinter中完整显示图片。测试图片可通过以下命令获取：

curl https://i.imgur.com/VYdf3vp.png --output pic.png

测试代码：

from tkinter import Tk, Label, PhotoImage, Canvas

# Create the main window
window = Tk()
window.title("Image Viewer")
window.geometry("600x600")

# Load and display the image
# curl https://i.imgur.com/VYdf3vp.png --output pic.png
image = PhotoImage(file="./pic.png")
label = Label(window, image=image)
# Doesn't help
# label = Label(window, image=image, anchor="nw", padx=10, pady=10)
label.pack()

# Doesn't help
# label.config(width=image.width(), height=image.height())

# Doesn't help
# desired_width = image.width()
# desired_height = image.height()
# label.config(width=desired_width, height=desired_height)

# Doesn't help
# label.place(x=0, y=0, width=desired_width, height=desired_height)

# Doesn't help
# canvas = Canvas(window, width=image.width(), height=image.height())
# canvas.pack()
# canvas.create_image(0, 0, anchor="nw", image=image)

# Start the tkinter event loop
window.mainloop()

解决思路及代码示例 #

1. 保留图片对象引用（防止垃圾回收） #

Tkinter的PhotoImage对象如果没有额外引用，会被Python垃圾回收机制回收，导致图片无法完整显示或消失。只需将图片对象绑定到Label的属性上：

from tkinter import Tk, Label, PhotoImage

window = Tk()
window.title("Image Viewer")
window.geometry("600x600")

image = PhotoImage(file="./pic.png")
label = Label(window, image=image)
# 关键：保留图片引用，避免被回收
label.image = image
label.pack(fill="both", expand=True)

window.mainloop()

2. 使用PIL库扩展图片支持 #

Tkinter原生PhotoImage对部分PNG格式（如带复杂Alpha通道）支持有限，使用PIL的ImageTk模块可处理更多图片格式，确保完整显示：
先安装PIL：

pip install pillow

修改后的代码：

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

window = Tk()
window.title("Image Viewer")
window.geometry("600x600")

# 用PIL加载图片，兼容更多格式
pil_image = Image.open("./pic.png")
image = ImageTk.PhotoImage(pil_image)

label = Label(window, image=image)
label.image = image
label.pack(fill="both", expand=True)

window.mainloop()

3. 缩放图片适配窗口（可选） #

如果图片尺寸超过窗口大小，可按比例缩放后再显示：

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

window = Tk()
window.title("Image Viewer")
window.geometry("600x600")

pil_image = Image.open("./pic.png")
# 按窗口尺寸等比例缩放图片
pil_image.thumbnail((600, 600))
image = ImageTk.PhotoImage(pil_image)

label = Label(window, image=image)
label.image = image
label.pack()

window.mainloop()

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