已配置PATH仍报错：无法执行WindowsPath('dot')，求Graphviz解决办法

问题背景 #

已在Windows 10系统通过官网安装程序部署Graphviz，为Python 3.10.1安装了graphviz库，且将C:\Program Files\Graphviz\bin添加至系统和用户PATH环境变量，但仍触发以下报错：

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

示例代码：

import graphviz

d = graphviz.Digraph(filename='rank_same.gv')

with d.subgraph() as s:
    s.attr(rank='same')
    s.node('A')
    s.node('X')

d.node('C')

with d.subgraph() as s:
    s.attr(rank='same')
    s.node('B')
    s.node('D')
    s.node('Y')

d.edges(['AB', 'AC', 'CD', 'XY'])

d.view()

额外解决办法 #

• 重启所有相关进程：PATH修改后，已打开的终端、IDE（如VS Code、PyCharm）不会自动加载新配置，需完全关闭后重新启动，确保Python进程读取到更新后的PATH。
• 手动指定dot.exe路径：绕过PATH依赖，直接在代码中指定Graphviz可执行文件的完整路径，修改示例代码如下：

  import graphviz
  
  # 替换为你的dot.exe实际路径
  d = graphviz.Digraph(filename='rank_same.gv', engine='dot', executable=r'C:\Program Files\Graphviz\bin\dot.exe')
  
  with d.subgraph() as s:
      s.attr(rank='same')
      s.node('A')
      s.node('X')
  
  d.node('C')
  
  with d.subgraph() as s:
      s.attr(rank='same')
      s.node('B')
      s.node('D')
      s.node('Y')
  
  d.edges(['AB', 'AC', 'CD', 'XY'])
  
  d.view()
  

• 验证PATH生效状态：打开新的命令提示符，执行dot -V，若能输出版本信息则PATH配置有效；若失败，检查路径是否存在拼写错误、是否匹配Graphviz实际安装目录（如64位程序可能安装在C:\Program Files (x86)\Graphviz\bin），或重启电脑后再次验证。
• 检查Python进程的PATH：在Python环境中运行以下代码，确认Graphviz的bin目录是否在当前进程的PATH列表中：

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

  若不在，说明当前Python进程未读取到更新后的PATH，重启IDE/终端即可。
• 重装graphviz库：若库文件损坏，执行以下命令重装：

  pip uninstall graphviz -y
  pip install graphviz
  

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