我正在使用Sphinx文档工具，它显示错误：“cmp中超出了最大递归深度”

Question

我正在使用Sphinx文档工具。在使用HTML文件制作RST文件时，会显示以下错误并提示解决错误：

  

递归错误：cmp超出了最大递归深度。对于非常大或深度嵌套的源文件，可能会发生这种情况。

     

您可以小心地增加默认的Python递归限制1000   conf.py示例：

     

import sys; sys.setrecursionlimit(1500)

我尝试增加sys.setrecursionlimit()，但此解决方案无法解决。

除此之外，我尝试更改HTML输出的主题。但错误仍然存​​在;无论HTML主题如何。

Answer 1

我有同样的问题，并尝试慢慢增加recursionLimit，这是浪费时间（开始在~40300处出现分段错误）。

为我解决问题的是编辑我的index.rst

我有像这样的toctree的通配符

MyCodeLibrary
##############

.. toctree::
   :glob:

   /*

我通过这样做来修复它：

MyCodeLibrary
##############

.. toctree::
   :glob:

   mycodelibrary/*

希望这有帮助！