Dot 不能在 Pycharm 中使用 Sphinx 和 Graphviz 运行答案

【问题标题】：Dot cannot be run in Pycharm with Sphinx and GraphvizDot 不能在 Pycharm 中使用 Sphinx 和 Graphviz 运行
【发布时间】：2021-09-28 04:49:23
【问题描述】：

我正在尝试使用 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文件，所以我不明白出了什么问题。已经向here 提出了 Mac OS 的类似问题。我尝试了该解决方案，但它似乎只适用于 Mac，因为当我将 export PATH=$PATH:~/opt/bin 粘贴到 Pycharm 终端时，它告诉我找不到命令 export。老实说，我很难理解为什么有时您可以只使用软件包，而有时即使安装了它们也找不到它们，我是自学成才和初学者。

【问题讨论】：

我不认为这是重复的，另一篇文章中的解决方案对我不起作用，此外，我认为我需要比那里提供的更多信息。我也在我的问题中链接了这个问题。
@mzjn 似乎 Graphviz 已在另一篇文章中全局安装。我没有文件夹 C:\Program Files (x86)\GraphvizX.XX\bin 开始。而且我认为在Pycharm虚拟环境中安装包时不应该有这样的文件夹。我之前在 Pycharm 虚拟环境中安装过 pip 包，我总是可以在自己的项目中使用它们。
@bad_coder 我认为这是在 Pycharm 虚拟环境中自动执行的，我可以在虚拟环境中运行其他包，例如 Sphinx 没有问题。
为 Windows 安装 Graphviz 确实解决了这个问题。但我还是不明白为什么。我之前在我的虚拟环境中运行过 pip install graphviz，所以安装了 Graphviz。但是我需要在 Windows 上全局安装 Graphviz。为什么需要这样做？
谢谢，现在我的问题似乎很愚蠢。我不知道包有时有外部依赖项。我的意思是 pip install graphviz 也可以自动将 graphviz.exe 安装到虚拟环境中，如下所述：stackoverflow.com/questions/3271590/…

标签： path pycharm python-sphinx graphviz dot

【解决方案1】：

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

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

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

【讨论】：