Mac环境下运行Python代码无法生成Graphviz图形的问题求助

问题背景 #

已完成以下配置：

• 通过brew install graphviz在Mac上安装Graphviz，/usr/local/Cellar/graphviz/12.2.1/bin/目录下存在dot等可执行文件
• 通过pip3 install graphviz安装Python的graphviz库
• PATH变量已添加/usr/local/Cellar/graphviz/12.2.1/bin/路径

但运行生成图形的Python代码时，抛出错误：

graphviz.backend.execute.ExecutableNotFound: failed to execute PosixPath('dot'), make sure the Graphviz executables are on your systems' PATH

而终端直接执行/usr/local/Cellar/graphviz/12.2.1/bin/dot -T jpeg -O sample.dot完全正常。

可能原因与解决方案 #

1. Python运行环境的PATH与终端PATH不一致 #

终端里配置的PATH并没有同步到Python代码的运行环境（比如IDE启动时未继承终端环境变量，或脚本运行的shell环境未加载最新配置）。

临时解决：代码中指定dot绝对路径

在创建Digraph实例时，直接通过executable参数指定dot的完整路径，绕过PATH查找：

g1 = graphviz.Digraph(name="my_graph", executable="/usr/local/Cellar/graphviz/12.2.1/bin/dot")

永久解决：统一运行环境的PATH

• IDE运行场景：打开IDE的环境变量设置（比如VS Code的Python环境配置、PyCharm的运行/调试配置），将/usr/local/Cellar/graphviz/12.2.1/bin/添加到PATH变量中。
• 终端运行场景：先在脚本开头添加代码打印当前环境的PATH，确认是否包含目标路径：

  import os
  print(os.environ.get('PATH'))
  

  如果输出里没有目标路径，执行source ~/.zshrc（或source ~/.bash_profile，根据你使用的shell）重新加载环境配置，再运行脚本。

2. 改用brew的全局symlink路径 #

brew安装的Graphviz通常会在/usr/local/bin下创建全局symlink，避免因版本更新导致PATH失效。你可以：

1. 检查/usr/local/bin/dot是否存在，若不存在，执行brew link graphviz创建symlink
2. 确保/usr/local/bin在你的PATH中（Mac默认已包含），之后Python就能通过全局symlink找到dot命令

内容的提问来源于stack exchange，提问作者AnilJ