使用Tkinter的askopenfilename()上传图片后无法显示的问题

你遇到的问题是使用askopenfilename选中图片后，Canvas无法显示图片且无报错，核心原因是函数内创建的PhotoImage对象被垃圾回收。

问题分析 #

在upload函数里创建的image = PhotoImage(file=path)是局部变量，函数执行完毕后，Python会自动回收这个局部变量，导致Canvas找不到对应的图片对象，因此无法显示。

另外需要注意：Tkinter原生的PhotoImage仅支持PNG和GIF格式，如果选中JPG图片，原生PhotoImage无法加载（不会报错，但显示空白），这种情况需要借助PIL库的ImageTk模块处理。

解决方案 #

1. 将PhotoImage对象绑定到Canvas的属性上，避免被垃圾回收；
2. 若要支持JPG格式，引入PIL库的Image和ImageTk模块。

修改后的代码

from tkinter import *
from tkinter.messagebox import showinfo
from tkinter import filedialog as fd
# 支持JPG需安装PIL（执行pip install pillow），并导入以下模块
from PIL import Image, ImageTk

window = Tk()
window.title("Watermark Generator")
window.config(pady=50, padx=50, bg="#643843")

# ----- Canvas for the uploaded pic -----
canvas = Canvas(
    width=200,
    height=200,
    bg="#99627A",
    highlightthickness=0
)
canvas.grid(row=0, column=0)


# ----- Upload Action -----
def upload():
    filetypes = (
        ("PNG files", "*.png"),
        ("JPEG files", "*.jpg"),
        ("All files", "*.*")
    )

    path = fd.askopenfilename(
            title="Open an image",
            initialdir="/Desktop",
            filetypes=filetypes
    )
    if not path:  # 取消选择时直接返回，避免空路径报错
        return

    showinfo(
            title="Selected image",
            message="Successfully uploaded"
    )

    # 兼容处理不同格式图片
    try:
        # 用PIL处理JPG，同时兼容PNG
        img = Image.open(path)
        # 缩放图片适配Canvas大小（可选）
        img.thumbnail((200, 200))
        image = ImageTk.PhotoImage(img)
    except:
        # 降级到原生PhotoImage（仅支持PNG/GIF）
        image = PhotoImage(file=path)
    
    # 绑定image到Canvas属性，防止被垃圾回收
    canvas.image = image
    # 清空Canvas之前的内容，避免重复叠加显示
    canvas.delete("all")
    canvas.create_image(100, 100, image=image)


# ----- Button -----
upload_button = Button(
    window,
    text="Upload Image",
    font=("arial", 15, "bold"),
    highlightthickness=0,
    border=0,
    bg="#99627A",
    fg="#E7CBCB",
    command=upload
)
upload_button.grid(row=0, column=1, padx=30)

window.mainloop()

关键修改点 #

• canvas.image = image：将图片对象绑定到Canvas实例上，使其不会被垃圾回收；
• 增加PIL库支持JPG格式，并添加图片缩放适配Canvas大小；
• 增加取消选择图片的判断，避免空路径报错；
• 每次显示新图片前清空Canvas，避免叠加显示。

水印预览的兼容方法 #

添加水印后的图片预览可以复用同样逻辑：

1. 处理图片（添加水印）后，将其转换为ImageTk.PhotoImage对象；
2. 绑定到Canvas属性，再通过canvas.create_image显示即可。

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