sphinx 文档从 :inherited-members 中排除了一个基类：

Question

我正在使用 Sphinx 记录一些具有多层继承的 Python 代码。结构大致是：

class _foo(np.ndarray):
    #do _foo stuff

class bar(_foo):
    #do bar stuff

class baz(_foo):
    #do baz stuff

使用 :inherited-members: 在我的 .rst 文件中，我从 _foo 获取文档作为 bar 和 baz 的一部分，但我也从 np.ndarray 获取所有文档，我不想要.

Sphinx 文档 (https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html) 说：

例如；如果您的类 Foo 是从列表类派生的，并且您不想记录 list.__len__()，您应该指定一个选项 :inherited-members: list 以避免列表类的特殊成员。

但我试过了：

• ：继承成员：np.ndarray
• :inherited-members: ndarray
• :inherited-members: numpy.ndarray

这些都不会阻止每个类都包含整个 numpy.ndarray 文档。有谁知道是否有办法排除 numpy 文档，但保留我需要的部分？谢谢。

Answer 1

正如@Masklinn 在 cmets 中解释的那样，需要 3.0 或更高版本，然后它可以正常工作：

:inherited-members: ndarray