pip install graphviz 仅安装 Python 接口库，不包含 dot 等核心可执行文件；必须单独安装 Graphviz 二进制程序，并将其路径正确添加到系统 PATH 中。
`pip install graphviz` 仅安装 python 接口库，不包含 `dot` 等核心可执行文件；必须单独安装 graphviz 二进制程序，并将其路径正确添加到系统 path 中。
graphviz 是一个常用于生成流程图、状态机、依赖图等结构化图形的开源工具。Python 中的 graphviz 包（PyPI 上的 graphviz）本质上是一个纯 Python 封装库——它负责生成 DOT 格式的文本描述，但不包含任何渲染引擎或可执行程序。真正执行绘图任务的是 dot、neato、fdp 等命令行工具，它们属于 Graphviz 官方发布的独立二进制套件。
因此，当你看到如下报错：
graphviz.backend.execute.ExecutableNotFound: failed to execute PosixPath('dot'),
make sure the Graphviz executables are on your system's PATH
这明确表示：Python 找不到系统级的 dot 命令，而非 Python 包本身有问题。
✅ 正确解决方案（无需 Homebrew）
虽然你希望避免 Homebrew，但仍有可靠替代方案：
1. 直接下载并安装官方 macOS 二进制包（推荐）
- 访问 Graphviz 官方下载页：https://www.php.cn/link/9c20589c29266540045a9cbfdf12c64a
- 下载最新 .pkg 安装包（如 graphviz-9.0.0.pkg）
- 双击安装（默认安装路径为 /usr/local/bin/，含 dot、circo 等可执行文件）
2. 验证安装是否成功
终端中运行：
which dot # 应输出：/usr/local/bin/dot dot -V # 应输出类似：dot - graphviz version 9.0.0 (20231004.1730)
3. 确保 PATH 已包含该路径（关键！）
即使已安装，若 Shell 未加载 /usr/local/bin，Python 仍不可见。请检查并修正：
# 查看当前 PATH echo $PATH # 若无 /usr/local/bin，请在 shell 配置文件中添加（根据你的 shell 选择）： # ~/.zshrc（macOS Catalina 及之后默认）或 ~/.bash_profile（旧版） echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
⚠️ 注意：你之前尝试的 export PATH=".../site-packages/graphviz" 是无效的——该路径下只有 Python 模块代码（.py 文件），没有 dot 可执行文件。
4. Python 代码中无需额外配置（只要 PATH 正确）
from graphviz import Digraph
dot = Digraph(comment='测试图')
dot.node('A', '起点')
dot.node('B', '终点')
dot.edge('A', 'B', '执行')
dot.render('output/test-output', format='png', cleanup=True)
print("✅ 图形已生成：output/test-output.png")
只要系统能调用 dot，上述代码即可正常运行。
? 总结
- pip install graphviz ≠ 安装 Graphviz 引擎；二者职责分离，缺一不可。
- 必须通过官方 .pkg、MacPorts 或（谨慎使用的）Homebrew 安装原生 Graphviz。
- PATH 配置必须指向可执行文件所在目录（通常是 /usr/local/bin），而非 Python 包路径。
- 安装后务必用 dot -V 和 which dot 验证，再运行 Python 脚本。
完成以上步骤，ExecutableNotFound 错误将彻底消失。
