Python Sphinx autodoc发出警告:py:未找到类引用目标:类型警告

Python Sphinx autodoc发出警告:py:未找到类引用目标:类型警告,python,python-sphinx,metaclass,autodoc,Python,Python Sphinx,Metaclass,Autodoc,我有一些在python中使用元类的代码。但在运行sphinx autodoc时,会出现以下错误: 警告:py:未找到类引用目标:类型 错误发生在自动生成的.rst文件的一行中: .. automodule:: API.list.blockList :members: # this is the line in error :show-inheritance: 而blockList扩展了API.list.list,它将\\uu元类\uu设置为我的元类 据我所知,sphinx不认为

我有一些在python中使用元类的代码。但在运行sphinx autodoc时,会出现以下错误:

警告:py:未找到类引用目标:类型

错误发生在自动生成的.rst文件的一行中:

.. automodule:: API.list.blockList
    :members: # this is the line in error
    :show-inheritance:
而blockList扩展了API.list.list,它将
\\uu元类\uu
设置为我的元类

据我所知,sphinx不认为内置类型类存在。我试着导入内置类型,让sphinx意识到它就在那里,但没有成功


如果我从API.list.list中删除元类分配,并从代码中删除元类,那么sphinx就可以正常工作。

这只是Python文档本身的一个bug——对一些Python内置(包括
类型
)的引用无法正确解析(例如,请参阅)

要消除警告,可以将该选项添加到Sphinx配置中。例如,在Astropy项目中,我们有:

nitpick_ignore = [('py:class', 'type')]
事实上,有足够多的异常,我们只是把它们都放在一个单独的文件中,然后从中读取它们。见:

对于异常文件本身:


上述文件中的许多异常都是特定于Astropy的,但其他异常在Python和Numpy中处理了一些不完整的引用,并且可能非常有用。

您能提供一个触发此异常的最小示例吗?