Tkinter 无法直接显示 PDF 缩略图，因其 PhotoImage 仅支持 GIF、PPM/PGM 和 PNG，不识别 PDF 格式；必须经 PyMuPDF 将 PDF 页面转为 PIL.Image（如通过 get_pixmap(dpi=120)），再转为 PhotoImage，同时注意 alpha 处理、内存缓存与线程安全。
为什么直接用 Tkinter 无法显示 PDF 缩略图
Tkinter 自身不支持 PDF 渲染，它的 PhotoImage 只认 GIF、PPM/PGM 和 PNG（仅较新版本），PDF 不在支持列表里。试图用 PhotoImage(file="xxx.pdf") 会直接报 TclError: couldn't recognize image data。必须先将 PDF 页面转成位图（如 PNG），再加载进 Tkinter。
用 PyMuPDF（fitz）快速提取页面为 PIL 图像
PyMuPDF 是目前 Python 中最轻量、最可靠、无需系统依赖的 PDF 页面渲染方案。它能直接输出 PIL.Image 对象，和 Tkinter 的图像流程天然契合。
- 安装命令：
pip install PyMuPDF（注意不是fitz独立包，fitz是PyMuPDF的模块名） - 关键步骤：打开文档 → 获取某页 →
get_pixmap(dpi=120)→ 转PIL.Image→ 转PhotoImage -
dpi值影响缩略图清晰度与内存占用：96–150 是预览常用区间；超过 200 容易卡顿，尤其多页时 - 示例片段：
import fitz
from PIL import Image
import io
<p>doc = fitz.open("sample.pdf")
page = doc[0] # 第一页
pix = page.get_pixmap(dpi=120)
img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)</p><h1>后续转 PhotoImage...把 PIL 图像安全转成 Tkinter.PhotoImage
PhotoImage 只接受特定模式（如 "P"、"RGB"、"RGBA"），而 PyMuPDF 输出的 pix.samples 默认是 RGB，但若 PDF 含透明区域，pix 可能是带 alpha 的 4 字节数据，此时需显式指定 mode="RGBA"，否则 Image.frombytes 会出错或颜色异常。
- 稳妥写法：检查
pix.alpha，动态选 mode："RGBA" if pix.alpha else "RGB" - 必须用
io.BytesIO+Image.open()或直接Image.frombytes()，不能用Image.open("xxx.pdf")—— PIL 也不原生读 PDF -
PhotoImage对象需在Tk实例创建**之后**生成，且不能被 GC 回收：必须绑定到 widget 属性（如label.image = photo）或全局变量
滚动预览多页时的内存与响应性控制
一次性把所有 PDF 页面都转成 PhotoImage 会导致内存暴涨（尤其大文件），UI 卡死。真实可用的缩略图列表必须按需加载、缓存有限页、及时丢弃不用的图像对象。
立即学习“Python免费学习笔记（深入）”；
- 不要提前生成全部
PhotoImage；监听Canvas滚动或Listbox选择事件，只处理当前可视区域 ±1 页 - 用字典缓存最近访问的页码 →
PhotoImage映射，设置上限（如最多缓存 10 个），超出时del最久未用项 - 调用
photo.__del__()不可靠；应设为None并触发gc.collect()（虽不强制，但有助于释放底层 Tk 图像资源） - 避免在主线程做
get_pixmap：大于 50 页的文档建议用threading.Thread预取，但更新Label必须用root.after(0, ...)回到主线程
PDF 缩略图看似只是“显示一张图”，实际卡点全在渲染链路的衔接细节：dpi 选多少、alpha 怎么处理、图像对象生命周期怎么管——漏掉任意一环，要么黑图，要么 OOM，要么滚不动。
