Sphinx 找不到模块但 Python 可以

Sphinx cannot find module but Python can

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

ImportError: No module named 'statstuff'

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

SystemError: Parent module '' not loaded, cannot perform relative import

此外，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 在编写代码（或配置）时找不到模块。

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

非常感谢！

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

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

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

  2. 编辑 automodule 指令。更改 

    .. automodule:: probability

    到

    .. automodule:: statstuff.probability

    等等。