Windows10/M1 Mac系统如何为Polars正确配置Graphviz

通过pip安装的graphviz==0.20是Python层的调用封装库，本身不包含Graphviz官方的dot可执行二进制文件。将Python site-packages路径加入PATH的操作完全无效，这是触发报错的直接原因。

Windows 10（x86_64） #

• 先把之前误加进系统PATH的Graphviz相关site-packages路径删掉，避免无效路径干扰
• 安装Graphviz官方Windows安装包，安装过程中务必勾选Add Graphviz to system PATH for all users选项
• 安装完成后，全部关闭已打开的终端、Python IDE、Jupyter Notebook，重新打开程序让新的PATH环境变量加载生效
• 打开新终端执行dot -V，如果正常输出Graphviz版本号，说明二进制配置成功
• 回到Python环境调用df.show_graph(optimized=True)即可正常生成执行计划图

如果安装时漏选了添加PATH的选项，手动把Graphviz安装目录下的bin文件夹（默认路径为C:\Program Files\Graphviz\bin）加入系统环境变量PATH，重启终端后再验证即可。

Apple Silicon M1 系列Mac（Monterey系统） #

• 打开终端，通过Homebrew安装系统级Graphviz，执行命令：brew install graphviz
• 安装完成后执行which dot，正常返回路径为/opt/homebrew/bin/dot，再执行dot -V确认能正常输出版本信息
• 如果你用conda虚拟环境，额外执行conda install python-graphviz补全环境内依赖；如果是pip/venv虚拟环境，确认已安装matplotlib和graphvizPython包即可
• 重启正在运行的Python IDE、Notebook进程，重新运行代码即可正常调用show_graph功能

如果终端能正常识别dot命令，但Python环境仍报找不到二进制的错误，在代码最开头添加以下两行手动指定路径即可：

import os
os.environ["PATH"] += os.pathsep + "/opt/homebrew/bin"

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