擅长:python、mysql、java
<blockquote>
<pre><code>sys.path.insert(0, os.path.abspath('../..'))
</code></pre>
</blockquote>
<p>那是不对的。Steve Piercy的评论并不完全正确(您不需要添加<code>__init__.py</code>,因为您使用的是一个简单的模块),但他们说autodoc将尝试导入模块,然后检查内容是正确的</p>
<p>假设你的树是</p>
<pre><code>doc/conf.py
src/stack.py
</code></pre>
<p>然后,您只需将包含您的存储库的文件夹添加到sys.path,这是完全无用的。您需要做的是将<code>src</code>文件夹添加到sys.path,这样当sphinx尝试导入<code>stack</code>时,它就会找到您的模块。所以你的路线应该是:</p>
<blockquote>
<pre><code>sys.path.insert(0, os.path.abspath('../src')
</code></pre>
</blockquote>
<p>(路径应相对于conf.py)</p>
<p>值得注意的是:由于你有一些完全合成的东西,并且不应该包含任何秘密,因此一个可访问的存储库或整个东西的zip文件可以使诊断问题和提供相关帮助变得更加容易:推断的越少,答案中的错误就越少</p>