Graphviz+Doxygen无法生成类层次结构UML类图求助

问题描述 #

尝试用Doxygen结合Graphviz生成UML风格类图，UML_LOOK = YES配置未按预期作用在Class Hierarchy上。已删除输出文件、调整配置，也试过相关方案，仍生成非UML样式的Class Hierarchy图表。

更新：单个类的Collaboration Diagram和Inheritance Diagram可以正常生成UML样式，但Class Hierarchy无法生效。

当前Doxygen配置 #

OUTPUT_DIRECTORY       = D:/DCasado/Desktop
TAB_SIZE               = 2
EXTENSION_MAPPING      = ctl=c++
CPP_CLI_SUPPORT        = YES
EXTRACT_ALL            = YES
EXTRACT_PRIVATE        = YES
EXTRACT_PRIV_VIRTUAL   = YES
EXTRACT_PACKAGE        = YES
EXTRACT_STATIC         = YES
EXTRACT_LOCAL_METHODS  = YES
FORCE_LOCAL_INCLUDES   = YES
INPUT                  = NTGYProj_sys1/scripts
RECURSIVE              = YES
SOURCE_BROWSER         = YES
CHM_FILE               = buscando.chm
HHC_LOCATION           = "C:/Program Files (x86)/HTML Help Workshop/hhc.exe"
GENERATE_TREEVIEW      = YES
GENERATE_LATEX         = NO
HIDE_UNDOC_RELATIONS   = NO
HAVE_DOT               = YES
UML_LOOK               = YES
UML_LIMIT_NUM_FIELDS   = 50
TEMPLATE_RELATIONS     = YES
DOT_PATH               = "../../../Program Files/Graphviz/bin"
DOT_GRAPH_MAX_NODES    = 100
CLASS_GRAPH            = YES
COLLABORATION_GRAPH    = YES

排查建议 #

• 确认Doxygen版本：部分旧版本的UML_LOOK仅对单个类的继承/协作图生效，对全局Class Hierarchy不支持，建议升级到最新稳定版重试。
• 修正DOT_PATH配置：将相对路径改为绝对路径（比如C:/Program Files/Graphviz/bin），避免路径解析错误导致Graphviz调用异常。
• 启用HIDE_UNDOC_CLASSES：如果存在大量未文档化的类，可能干扰全局层级图的样式生成，尝试设置为YES后重新生成。
• 查看Doxygen运行日志：执行doxygen -d all启用全量日志，搜索与UML渲染、Graphviz调用相关的错误或警告，定位问题根源。

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