忽略 autodoc 中的一些模块答案

【问题标题】：Ignore some modules in autodoc忽略 autodoc 中的一些模块
【发布时间】：2015-12-22 05:50:03
【问题描述】：

我正在尝试仅对选定的模块使用自动文档。我创建了一个文件，其中包括：

.. automodule:: some.specific.module
   :members:

它会正确生成。不幸的是，autodoc 也一直在尝试解析其他文件（并且由于导入错误而失败）。我知道我可以模拟一些模块，但我想要一个更好的解决方案 - 从一开始就阻止 sphinx 查看它们。

如何确保只加载请求的模块，而不是（例如）test.other.module。

【问题讨论】：

【解决方案1】：

结果证明这是一个愚蠢的错误。由于某些工具会为 api 文档源生成脚手架，因此这些文件被搁置并触发了错误的导入。

这是如何找到的：

 [autodoc] /path/to/the/doc.rst:158: input:
 .. automodule:: app.module.name
    :members:

【讨论】：

【解决方案2】：

我看到了三种可能的原因：

【讨论】：