PyMuPDF中嵌套无序列表导致有序列表计数错误的解决方案

在Python的PDF处理库PyMuPDF中，开发者们发现了一个影响文档排版的问题。当在有序列表（<ol>）中嵌套无序列表（<ul>）时，会导致有序列表的计数系统出现异常。这个问题在1.24.9版本中被报告，并在后续的1.24.14版本中得到了修复。

问题现象

该问题表现为：当有序列表项中包含无序子列表时，无序列表项会被错误地计入有序列表的计数系统中。例如，在一个包含3个主项的有序列表中，如果第一个主项下包含2个无序子项，那么第二个主项的编号会错误地显示为4而不是2。

技术分析

这个问题源于PyMuPDF底层对HTML列表结构的解析逻辑。在标准的HTML规范中，有序列表和无序列表属于不同的计数系统，它们应该互不干扰。然而在PyMuPDF的实现中，列表计数器被设计为全局共享，没有为不同类型的列表建立独立的计数上下文。

解决方案

开发团队通过修改列表计数逻辑解决了这个问题。新的实现确保：

1. 有序列表和无序列表使用独立的计数器
2. 嵌套列表会创建新的计数上下文
3. 列表类型切换时会正确重置计数器

影响版本

• 受影响版本：1.24.9及之前版本
• 修复版本：1.24.14

开发者建议

对于需要使用复杂列表结构的开发者，建议：

1. 升级到1.24.14或更高版本
2. 在文档中使用标准的HTML列表嵌套语法
3. 避免在旧版本中混合使用不同类型的嵌套列表

这个问题展示了PyMuPDF团队对文档排版准确性的重视，也提醒开发者在处理复杂文档结构时要注意版本兼容性。