Doxygen标注Python类成员如何避免违反PEP8的E266规则？

以下方案均可同时满足Doxygen成员文档识别和PEP8规范要求，无需单独忽略E266错误：

• 方案1：使用三重引号文档字符串（docstring）标注
  Doxygen 1.8.10及以上版本原生支持解析Python标准的三重引号docstring，配合@brief等Doxygen标记即可实现成员文档标注，完全符合PEP8规范。
  实例成员示例：

class Foo:
    def __init__(self):
        self.bar = 7
        """! @brief 这是一个公共成员
        此处可补充成员的详细描述、取值范围、注意事项等内容
        """

类属性示例：

class Foo:
    baz = 9
    """@brief 这是类属性的说明"""

• 方案2：修改Doxygen配置自定义注释前缀
  修改Doxygen配置文件（Doxyfile）中的COMMENT_ATTRIBUTE_PREFIX配置项，将默认的##改为# （#号加单个空格），即可用符合PEP8要求的单行注释标注成员文档，Doxygen会自动识别为对应成员的说明内容。
  示例代码：

class Foo:
    def __init__(self):
        # 这是一个公共成员
        self.bar = 7

• 方案3：通过@property装饰器的docstring标注
  如果成员是对外暴露的可访问属性，可改用@property装饰器定义，直接在property的docstring中编写说明，Doxygen会自动将该docstring识别为属性的正式文档，完全符合PEP8规范。
  示例代码：

class Foo:
    def __init__(self):
        self._bar = 7
    
    @property
    def bar(self):
        """这是一个公共成员"""
        return self._bar
    
    @bar.setter
    def bar(self, value):
        self._bar = value

内容的提问来源于stack exchange，提问作者buhtz