如何用Pyreverse从Python代码生成UML类图？空白图问题求解

问题根源 #

你遇到的空白图问题主要来自两个方面：

1. 扫描范围不全：仅指定./mainService.py作为扫描对象，项目核心类都在Entity/和Enum/目录下，Pyreverse无法自动识别这些未被指定的模块。
2. Graphviz依赖异常：Pyreverse本身不直接生成PNG格式，需要依赖Graphviz工具完成格式转换，如果工具未安装或路径配置错误，会导致生成失败或输出空白图。

解决方案步骤 #

1. 确认Graphviz已正确安装 #

Pyreverse生成PNG必须依赖Graphviz，先确保它已安装并可用：

• macOS：通过Homebrew安装：brew install graphviz
• Ubuntu/Debian：通过APT安装：sudo apt-get install graphviz
• Windows：从Graphviz官网下载安装包，安装后需将Graphviz的bin目录添加到系统环境变量PATH中。

验证安装：在终端执行dot -V，能输出版本信息即为安装成功。

2. 调整Pyreverse命令，扫描整个项目 #

不要只扫描单个文件，改为扫描项目根目录，确保所有模块被覆盖：

pyreverse -o png -p ShoppingCart ./

如果根目录有无关文件，可通过--ignore参数排除，或明确指定需要扫描的目录：

pyreverse -o png -p ShoppingCart ./Entity ./Enum ./mainService.py

3. 修复模块导入识别问题（可选） #

Pyreverse依赖Python的模块导入机制解析类关系，若项目使用相对导入，可能导致识别失败。可以做以下调整：

• 在项目根目录、Entity/、Enum/目录下分别创建空的__init__.py文件，将这些目录标记为Python包。
• 确保mainService.py中的导入语句使用绝对路径（比如from Entity.Product import Product），避免相对导入导致的识别异常。

4. 分步生成（备选方案） #

如果直接生成PNG仍有问题，可先生成中间格式的.dot文件，再手动用Graphviz转换：

# 生成dot格式的类图和包图
pyreverse -o dot -p ShoppingCart ./
# 将dot文件转换为PNG
dot -Tpng classes_ShoppingCart.dot -o ShoppingCart_classes.png
dot -Tpng packages_ShoppingCart.dot -o ShoppingCart_packages.png

执行完成后，当前目录会生成包含所有类关系的ShoppingCart_classes.png和包结构的ShoppingCart_packages.png。

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