已将dot加入PATH但Python Graphviz仍无法执行dot的问题求助

问题背景 #

已将Graphviz的bin目录添加到系统PATH，重启过IDE和电脑，命令行中可正常调用dot命令，但Python的graphviz库（版本0.20.1）仍报错无法找到dot，卸载重装Graphviz无效。

示例代码：

import graphviz
g = graphviz.Digraph('G', filename='hello.gv')
g.edge('Hello', 'World')
g.view()

错误栈核心信息：

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

可能的解决方法 #

1. 直接在代码中指定dot的绝对路径 #

绕过环境变量检测，直接告诉graphviz库dot的位置：

import graphviz
# 设置全局可执行文件路径
graphviz.set_executable(r'C:\Program Files\Graphviz\bin\dot.exe')  # 替换为你的实际安装路径

g = graphviz.Digraph('G', filename='hello.gv')
g.edge('Hello', 'World')
g.view()

或者在初始化图时单独指定：

import graphviz
g = graphviz.Digraph(
    'G', 
    filename='hello.gv', 
    executable=r'C:\Program Files\Graphviz\bin\dot.exe'
)
g.edge('Hello', 'World')
g.view()

2. 验证Python进程的PATH环境变量 #

系统PATH更新后，Python虚拟环境或当前进程可能未同步到最新PATH。先打印当前Python进程的PATH：

import os
print(os.environ['PATH'])

如果输出中没有Graphviz的bin目录，手动将其添加到进程PATH中：

import os
# Windows下路径分隔符为分号
os.environ['PATH'] += r';C:\Program Files\Graphviz\bin'

import graphviz
g = graphviz.Digraph('G', filename='hello.gv')
g.edge('Hello', 'World')
g.view()

3. 检查IDE的环境变量缓存 #

部分IDE会缓存环境变量，即使系统PATH已更新，IDE进程仍使用旧的环境配置。可以：

• 完全关闭IDE（包括后台运行的进程），重新启动后再运行脚本
• 在IDE内置终端中执行echo %PATH%，确认Graphviz路径存在后再运行脚本

4. 检查graphviz库与Graphviz工具的版本兼容性 #

当前使用的graphviz库版本0.20.1可能与安装的Graphviz工具版本存在兼容性问题。尝试调整库版本：

# 降级到旧版本
pip install graphviz==0.19
# 或者升级到最新版本
pip install --upgrade graphviz

5. 确认Graphviz安装路径的正确性 #

检查Graphviz的bin目录下是否确实存在dot.exe，避免安装时路径选择错误；同时确认Graphviz的位数（32/64位）与Python版本一致，避免因位数不匹配导致的调用失败。

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