Sphinx无法导入子包

Question

我有一个结构如下的项目目录：

|--sphinx
   |--mypackage
     |--__init__.py
     |--core
        |--__init__.py
        |--program.py
        |--foo.py
     |--factory
        |--__init__.py
        |--basefactory.py

首先，我sphinx-apidoc使用以下参数运行sphinx-apidoc ：

c:\Debug\sphinx>sphinx-apidoc -o "C:\Debug\Sphinx" "C:\Debug\Sphinx\mypackage" -f --full

这将在“输出”目录中创建文件夹结构，.bat和.rst文件等。 目前很好。

当我尝试运行make html ，出现错误/警告，指示：

WARNING: autodoc: failed to import module 'mypackage'; the following exception was raised:
No module named 'mypackage'
WARNING: autodoc: failed to import module 'core.foo' from module 'mypackage'; the following exception was raised:
No module named 'mypackage'
WARNING: autodoc: failed to import module 'core.program' from module 'mypackage'; the following exception was raised:
No module named 'mypackage'
WARNING: autodoc: failed to import module 'core' from module 'mypackage'; the following exception was raised:
No module named 'mypackage'
WARNING: autodoc: failed to import module 'factory.basefactory' from module 'mypackage'; the following exception was raised:
No module named 'mypackage'
WARNING: autodoc: failed to import module 'factory' from module 'mypackage'; the following exception was raised:
No module named 'mypackage'

其他类似的问题（ 1 ， 2 ， 3 ）建议修改sys.path.insert在声明中conf.py文件。

我试过使用：

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

但是结果是一样的。

如果我添加了包的根路径（ sys.path.insert(0, 'c:\\debug\\sphinx') ，我从Sphinx得到的错误更少，这一次只与您的子包core和factory ：

WARNING: autodoc: failed to import module 'program' from module 'mypackage.core'; the following exception was raised:
No module named 'foo'
WARNING: autodoc: failed to import module 'basefactory' from module 'mypackage.factory'; the following exception was raised:
No module named 'core'

最终，我可以通过在conf.py文件中插入所有路径来生成conf.py ：

sys.path.insert(0, 'c:\debug\sphinx')
sys.path.insert(0, 'c:\debug\sphinx\mypackage')
sys.path.insert(0, 'c:\debug\sphinx\mypackage\core')
sys.path.insert(0, 'c:\debug\sphinx\mypackage\factory')

但似乎我在这里做错了。 有没有我可以添加到一个单一的路径sys.path ，可以让没有输入错误这项工作？ 我是否必须对所有打包/子打包路径进行硬编码？ 否则，我做错了什么？