本文介绍如何利用 pymupdf（fitz）库在本地 pdf 文档中精准、可靠地绘制垂直线，解决表格结构缺失导致的解析难题，并提供可直接运行的代码示例与关键注意事项。
在处理无边框或弱结构化 PDF 表格（如 NBA 裁判伤病报告）时，原始 PDF 缺乏明确的列分隔线，会导致 tabula-py 等工具解析错位——数据“泄漏”至相邻列、空单元格无法对齐。一种高效的事前增强策略是：下载 PDF 后，在关键列位置动态添加垂直参考线，构建视觉化的网格骨架，显著提升后续 OCR 或表格提取的准确率。虽然 pypdf 支持注释式绘图，但其 Line 注解在实际渲染中常不显示（尤其在 Acrobat 等主流阅读器中），且易触发底层对象异常警告（如 Incorrect first char in NameObject:(None)），本质是注解未被正确嵌入内容流。
推荐采用 PyMuPDF（fitz） ——它直接操作 PDF 内容流（content stream），将线条作为原生图形指令写入页面，100% 保证可见性与跨阅读器兼容性，且性能优异、API 清晰。
✅ 正确实现：使用 PyMuPDF 绘制垂直线
首先安装依赖：
