Sphinx递归autosummary重复对象警告：:noindex:破坏链接

警告原因 #

你的模板配置中，automodule:: :members:指令会将模块内所有函数、类及其方法纳入搜索索引；而autosummary生成的类页面（通过class-template.rst里的autoclass::）又会再次对这些类的方法建立索引，导致同一对象被多次索引，触发重复警告。

可行解决方案 #

方案1：修改模块模板，让模块页面仅展示描述不索引成员

这是最推荐的方案，既消除重复索引，又完全保留所有链接功能。

修改module-template.rst中的automodule部分，去掉:members:，改用:no-members:避免模块页面索引内部成员，将成员的索引工作交给autosummary生成的子页面：

.. automodule:: {{ fullname }}
   :no-members:
   :undoc-members:  # 可选：保留模块级文档字符串的显示，不展开成员

修改后，模块页面仅渲染模块本身的文档内容，不会对内部函数、类成员建立索引；而autosummary生成的类/函数页面会负责对应对象的索引，完美避免重复，同时所有链接依然可正常点击跳转。

方案2：给类页面的autoclass添加:noindex:（不推荐）

如果不想改动模块页面的automodule行为，可以在class-template.rst的autoclass指令中添加:noindex:：

.. autoclass:: {{ objname }}
   :members:
   :show-inheritance:
   :inherited-members:
   :noindex:

但此方案会导致类页面的内容无法被搜索到，仅适合特殊场景使用。

验证效果 #

修改模板后重新执行Sphinx构建命令，重复对象警告会完全消失，同时autosummary生成的所有模块、函数、类链接依然保持可点击状态。

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