Dot 不能在带有 Sphinx 和 Graphviz 的 Pycharm 中运行

如何解决Dot 不能在带有 Sphinx 和 Graphviz 的 Pycharm 中运行

我正在尝试使用 sphinx 创建一个类图。为此，我在 Pycharm 中创建了一个虚拟环境并将其添加到 conf.py：

extensions = ['sphinx.ext.autodoc','sphinx.ext.inheritance_diagram']

在我的 spamfilter.rst 文件中，我添加了以下几行：

Diagrams
=================
.. inheritance-diagram:: spamfilter

输出不是图表，看起来像 this。

显示以下警告：

WARNING: dot command 'dot' cannot be run (needed for graphviz output),check the graphviz_dot setting

当我查看文件夹 C:\Users\Name\PycharmProjects\documentation\venv\Lib\site-packages\graphviz 时，有一个 dot.py文件，所以我不明白有什么问题。已针对 Mac OS 提出了类似的问题 here。我尝试了该解决方案，但它似乎只适用于 Mac，因为当我将 export PATH=$PATH:~/opt/bin 粘贴到 Pycharm 终端时，它告诉我找不到命令 export。老实说，我很难理解为什么有时您可以只使用软件包，而有时即使安装了它们也找不到，我是自学成才的初学者。

解决方法

“pip install graphviz”命令安装一个 Python 包，该包提供了一个到 Graphviz (https://pypi.org/project/graphviz) 的接口。 Sphinx 不需要此包。

为了使用 Sphinx 创建继承图，必须安装实际的 Graphviz 工具包（包括 dot.exe）。见https://www.graphviz.org。

如果 dot.exe 不在 PATH 中，您可以使用 graphviz_dot 配置选项。