狮身人面像包括私人属性，即使没有指示

Question

我没有在任何地方包括：private-Members：选项，但是Sphinx仍然在课堂文档中包含私人属性。我在做什么错？

MWE：

mypackage/foo.py：

class MyClass(object):
    """A class.

    Attributes
    ----------
    attr1 : float
        Attribute 1.
    attr2 : float
        Attribute 2.
    _private1 : float
        Private attribute 1.
    _private2 : float
        Private attribute 2.
    """
    pass

index.rst：

.. toctree::
    :maxdepth: 2
    :caption: Table of Contents

    foo

foo.rst：

``foo`` Module
==============

.. automodule:: mypackage.foo
    :members:

conf.py：

# -*- coding: utf-8 -*-
#
# Configuration file for the Sphinx documentation builder.

import os
import sys
sys.path.insert(0, os.path.abspath('../'))

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.napoleon',
]

source_suffix = '.rst'

master_doc = 'index'

language = 'en'

渲染html ：

Answer 1

缺少：私人会员：仅对狮身人面像通过解析Python代码找到的成员生效。例如：

class MyClass(object):
    """A class"""
    attr1 = 42  #: Attribute 1.
    attr2 = 43  #: Attribute 2.
    _private1 = 44  #: Private attribute 1.
    _private2 = 45  #: Private attribute 2.

在这种情况下，它不会记录_private1和_private2（没有：private>：private-Members：）。

但是，在您的情况下，_private1和_private2只是文档字符串中的文本。我怀疑在这种情况下，狮身人面像知道它们是班级的属性。