Sphinx 找不到模块，但 Python 可以

Question

Python 文档生成器 Sphinx 似乎不理解我的模块/包。 在make clean && make html ，运行此代码时： from statstuff import statistics as stats ，它输出：

导入错误：没有名为“statstuff”的模块

我还尝试将模块引用为from . import statistics as stats from . import statistics as stats ，因为模块在同一个包中，但 Sphinx 输出：

SystemError: 父模块 '' 未加载，无法执行相对导入

此外， config.py似乎正确配置为sys.path.insert(0, os.path.abspath('../statstuff/')) ，因为文档文件夹与 statstuff 文件夹共享其父文件夹。

无论如何，这里是包含文件的存储库： https : //github.com/lucasmauro/statstuff

问题发生在statstuff/regression.py第 2 行和第 3 行： https : //github.com/lucasmauro/statstuff/blob/master/statstuff/regression.py

代码与 Python 解释器一起正常运行，但 Sphinx 无法在编写代码（或配置）时找到模块。

有没有人知道如何解决这个问题？

真的非常感谢！

Answer 1

由于您的模块位于名为statstuff的包中，我建议如下：

1. 将statstuff上面目录的路径添加到statstuff中的sys.path ：

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

2. 编辑自动automodule指令。 改变

   .. automodule:: probability

   到

   .. automodule:: statstuff.probability

   等等。