Tkinter Canvas图片更新异常求助：PyMuPDF生成PDF预览失效

问题根源 #

Tkinter的PhotoImage（包括PyMuPDF转成的ppm格式图片对象）如果没有被Python变量持续引用，会被垃圾回收机制销毁，导致Canvas上的图片消失。你遇到的“触发异常后图片能更新”，大概率是异常处理过程中无意中保留了图片对象的引用，避免了被回收。

修复步骤 #

1. 保留图片引用：给应用实例添加一个属性，专门存储当前显示的图片对象，确保它不会被GC回收。
2. 规范更新流程：更新预览时，先清除Canvas上的旧内容，再生成新图片并保存引用，最后重新绘制。
3. 强制刷新界面：使用update_idletasks()强制Canvas立即刷新，确保新图片及时显示。

修正后的示例代码 #

import tkinter as tk
import fitz  # PyMuPDF

class PDFPreviewApp:
    def __init__(self, root):
        self.root = root
        self.canvas = tk.Canvas(root, width=400, height=500)
        self.canvas.pack()
        self.canvas.bind("<Double-Button-1>", self.update_preview)
        # 存储图片引用，防止被垃圾回收
        self.current_preview_img = None
        # 首次加载预览
        self.refresh_preview()

    def refresh_preview(self):
        # 打开PDF并生成预览图
        doc = fitz.open("test.pdf")
        page = doc[0]
        pix = page.get_pixmap()
        # 转成Tkinter支持的ppm格式
        img_data = pix.tobytes("ppm")
        img = tk.PhotoImage(data=img_data)
        
        # 保存图片引用到实例属性，避免被回收
        self.current_preview_img = img
        
        # 清除旧内容并绘制新图片
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor="nw", image=img)
        
        doc.close()
        # 强制刷新Canvas，确保图片立即显示
        self.canvas.update_idletasks()

    def update_preview(self, event):
        # 双击触发预览更新
        self.refresh_preview()

if __name__ == "__main__":
    root = tk.Tk()
    app = PDFPreviewApp(root)
    root.mainloop()

关键细节说明 #

• 必须将PhotoImage对象绑定到实例属性（比如self.current_preview_img），而不是局部变量——局部变量在函数执行完毕后会被销毁，导致图片对象失去引用被回收。
• update_idletasks()会处理所有待处理的界面更新任务，比update()更精准，避免不必要的事件循环干扰。
• 如果你的PDF预览涉及多页或更高分辨率的图片，保持引用的逻辑同样适用，只需在切换页时更新self.current_preview_img即可。

内容的提问来源于stack exchange，提问作者Павел Третьяков