pymupdf渲染pdf到tkinter canvas需经「pdf→像素图→tk图像」三步链：先用fitz.page.get_pixmap(dpi=144, matrix=fitz.matrix(2.0,2.0))生成高清图像，再转pil.image，最后用imagetk.photoimage加载并绑定至canvas.create_image()，同时严格管理photoimage引用、清空旧图像、配置scrollregion防截断。
PyMuPDF 渲染 PDF 页面到 Tkinter Canvas 的核心步骤
直接用 fitz.Page.get_pixmap() 生成图像数据，再转成 PIL.Image，最后用 ImageTk.PhotoImage 加载进 Canvas.create_image()。Tkinter 自身不支持 PDF 渲染，必须走「PDF → 像素图 → Tk 图像对象」这条链，跳过任意一环都会黑屏或报错。
关键不是“怎么显示”，而是“怎么让每页像素数据稳定、不失真、不卡顿”。常见错误是直接对高 DPI PDF 调用 get_pixmap() 不设 matrix，结果内存爆掉或渲染模糊。
-
fitz.Matrix必须显式传入，推荐用fitz.Matrix(2.0, 2.0)控制缩放（1.0 是原始尺寸，通常太小；2.0 接近屏幕阅读舒适尺度） - 务必指定
dpi=144或更高（get_pixmap(dpi=144)），否则文字边缘发虚，尤其在 Retina 屏上更明显 - 每次切换页面前，清空
Canvas上旧的PhotoImage引用，否则图像对象不会被 GC，内存持续上涨
处理多页 PDF 时 Canvas 缩放与滚动适配
Tkinter Canvas 默认不自动适配 PDF 页面尺寸变化，直接 create_image(0, 0, ...) 会导致右侧/下侧被截断。必须结合 configure(scrollregion=...) 和 scale() 手动对齐。
不要依赖 canvas.bbox("all") 动态算区域——PDF 页面宽高差异大，且 PhotoImage 对象在 create_image 后才真正绑定尺寸，顺序错了就白算。
- 先调用
pixmap = page.get_pixmap(...)，再用pixmap.width/pixmap.height算出目标画布区域 -
canvas.configure(scrollregion=(0, 0, pixmap.width, pixmap.height))必须在create_image之后立即执行 - 如果要做缩放控件（+/- 按钮），别改
PhotoImage，而是重新生成pixmap并更新scrollregion和create_image的 anchor 位置
常见崩溃点：PIL.ImageTk.PhotoImage 生命周期管理
最隐蔽的问题是：PhotoImage 实例一旦被 Canvas 引用，就强持有 PIL 图像数据；如果 Python 变量名被覆盖（比如 self.img = ... 被重复赋值），旧图像数据还在内存里，但引用丢失，Tk 就会 segfault 或抛 TclError: image "pyimageN" doesn't exist。
- 始终把
PhotoImage绑定到类实例属性（如self.current_img），而不是局部变量 - 每次换页前，先执行
self.canvas.delete("pdf_page")，再self.canvas.create_image(..., tag="pdf_page") - 避免用
ImageTk.PhotoImage(image=img).photo这种临时链式调用——返回的 PhotoImage 没有变量持有，下一帧就被回收
Windows 下中文乱码与字体回退问题
PyMuPDF 默认不嵌入中文字体渲染逻辑，遇到含中文的 PDF，get_pixmap() 可能出现方块或空白。这不是 Tkinter 的锅，是底层 MuPDF 渲染器找不到可用字体。
解决方案不是换库，而是提前注册系统字体路径。注意：PyMuPDF 2.0+ 的 fitz.Font 不再支持直接加载 .ttf，得靠 fitz.Page.get_text("dict") 辅助判断是否缺字，再针对性干预。
- Windows 上可硬编码
fitz.TOOLS.set_small_glyph_heights(True)改善小字号中文字形 - 若页面文本提取后含大量
""或" "，说明渲染失败，应 fallback 到page.get_text("blocks")+Canvas.create_text()叠加图层（仅限纯文本 PDF） - 避免在
get_pixmap()前调用page.get_text()—— 某些加密 PDF 会触发异常，应包在try/except fitz.EmptyPageError:里
PDF 渲染链路长、环节多，最容易被忽略的是 fitz.Document 实例的复用粒度：一个文档打开一次就够了，反复 fitz.open() 再 .close() 不仅慢，还可能触发 Windows 文件句柄泄漏。页面缓存、矩阵预计算、图像对象复用，这三个点没压住，滚动就会卡顿。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
