能否在Sphinx生成的文档中为方法组添加文档字符串？

当然可以实现！你想要的不是单纯把方法归类，而是给整个方法组加上专属的描述文档，这在Sphinx里有几种很实用的方案，我给你详细说说：

方案1：用.. rubric::快速定义组标题+组文档 #

这个方法不需要额外安装扩展，简单直接，适合快速落地。你可以在类的文档注释里，先通过rubric定义方法组的标题，紧接着写组的专属描述，再列出该组的方法。

举个代码示例：

class DataProcessor:
    """负责数据处理流程的核心类"""

    .. rubric:: 原始数据预处理方法组
    这一组方法专门针对未加工的原始数据做清洗、去重和格式转换，所有方法都以`raw_dataset`为输入，返回可直接用于分析的结构化数据。

    def remove_invalid_entries(self, raw_dataset):
        """移除数据集中的无效、缺失条目"""
        pass

    def standardize_format(self, raw_dataset):
        """将不同格式的字段统一为标准结构"""
        pass

生成的文档里，rubric会生成一个醒目的组标题，下面的段落就是你给这个方法组写的专属文档，之后跟着组内的方法列表，完全符合你的预期。

方案2：用autogroup扩展实现自动化分组（进阶） #

如果你的项目有大量方法组，想要更规范的自动化管理，可以用sphinxcontrib.autodoc_extensions里的autogroup功能（需要先安装这个扩展）。

操作步骤如下：

1. 先安装扩展：

pip install sphinxcontrib-autodoc-extensions

2. 在你的Sphinx配置文件conf.py里启用这个扩展：

extensions = [
    # 保留你已有的其他扩展，比如sphinx.ext.autodoc
    'sphinxcontrib.autodoc_extensions',
]

3. 在代码里用标签定义方法组和组文档：

class DataProcessor:
    """负责数据处理流程的核心类"""

    :autogroup: 原始数据预处理方法组
    :autogroup-doc: 这一组方法专门针对未加工的原始数据做清洗、去重和格式转换，所有方法都以`raw_dataset`为输入，返回可直接用于分析的结构化数据。

    def remove_invalid_entries(self, raw_dataset):
        """移除数据集中的无效、缺失条目"""
        pass

    def standardize_format(self, raw_dataset):
        """将不同格式的字段统一为标准结构"""
        pass

这样Sphinx会自动把标记了同一autogroup的方法归为一组，同时展示你定义的组专属文档，排版更规整，适合大型项目维护。

额外：手动在.rst文件中组织方法组 #

如果你习惯直接在Sphinx的reStructuredText源文件里控制文档结构，也可以手动分组并添加组文档：

.. autoclass:: your_module.DataProcessor
    :members:

    .. rubric:: 原始数据预处理方法组
    这一组方法专门针对未加工的原始数据做清洗、去重和格式转换，所有方法都以`raw_dataset`为输入，返回可直接用于分析的结构化数据。

    .. automethod:: remove_invalid_entries
    .. automethod:: standardize_format

这种方式完全由你手动控制分组逻辑和组文档，灵活性拉满。

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