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 ，可以讓沒有輸入錯誤這項工作？ 我是否必須對所有打包/子打包路徑進行硬編碼？ 否則，我做錯了什么？