如何解决Python Tkinter用tkPDFViewer打开PDF时堆叠展示历史文件的问题

问题原因 #

你遇到的PDF内容堆叠问题是tkPDFViewer库的内置设计导致的：ShowPdf类内部维护了一个全局缓存列表img_object_li，用来存储PDF渲染后的图片对象，每次调用pdf_view方法只会往这个列表追加新PDF的页面，不会主动清空上一次加载的内容，所以多次调用后就会把历史加载的所有PDF页面拼接在一起展示。

解决方案 #

可以根据你的使用场景选择以下两种修改方案：

方案1：每次加载新PDF前清空缓存，支持多窗口独立展示不同PDF #

每次实例化ShowPdf对象后，先手动清空它的内部缓存列表，再调用方法加载当前选中的PDF：

import tkinter as tk
from tkinter import messagebox
from tkPDFViewer import tkPDFViewer as pdf

def OnEntryLeft(event):
    # 先判断是否有选中项，避免无选中时程序报错
    if not listb.curselection():
        return
    cur_file = listb.get(listb.curselection())
    # 统一转小写判断后缀，兼容大小写格式的PDF扩展名
    if cur_file.lower().endswith(".pdf"):
        newWindow = tk.Toplevel(root)
        # 实例化ShowPdf对象
        pdf_viewer = pdf.ShowPdf()
        # 手动清空内部缓存的历史PDF渲染对象
        pdf_viewer.img_object_li.clear()
        # 加载当前选中的PDF
        pdf_viewer.pdf_view(newWindow, pdf_location=cur_file, width=75, height=100).pack()
    else:
        messagebox.showinfo("PDF-Check", "NO pdf")

方案2：复用同一个窗口展示PDF，避免多窗口堆叠 #

如果不需要同时打开多个PDF窗口，可以全局只保留一个PDF窗口，每次选中新PDF时直接清空旧窗口内容重新加载：

import tkinter as tk
from tkinter import messagebox
from tkPDFViewer import tkPDFViewer as pdf

# 全局变量保存PDF窗口和渲染对象
pdf_window = None
pdf_viewer = None

def OnEntryLeft(event):
    global pdf_window, pdf_viewer
    if not listb.curselection():
        return
    cur_file = listb.get(listb.curselection())
    if not cur_file.lower().endswith(".pdf"):
        messagebox.showinfo("PDF-Check", "NO pdf")
        return
    
    # 窗口已存在的话先销毁原有内容
    if pdf_window and pdf_window.winfo_exists():
        for widget in pdf_window.winfo_children():
            widget.destroy()
    else:
        # 窗口不存在就新建
        pdf_window = tk.Toplevel(root)
        pdf_viewer = pdf.ShowPdf()
    
    # 清空缓存加载新PDF
    pdf_viewer.img_object_li.clear()
    pdf_viewer.pdf_view(pdf_window, pdf_location=cur_file, width=75, height=100).pack()

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