如何使用 doxygen 从 C 源创建 UML 类图

Question

我一直在寻找一些描述如何使用 doxygen 生成简单类图的材料，但找不到。有人可以帮忙吗？

我需要从一组 C++ 文件中创建如下所示的图表。

如果有更好的工具可以更轻松地实现这一目标，请告诉我。

原文由 softwarematter 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

Doxygen 创建继承图，但我认为它不会创建整个类层次结构。它确实允许您使用 GraphViz 工具。如果您使用 Doxygen GUI 前端工具，您将在 Step2: -> Wizard tab -> Diagrams 中找到相关选项。 DOT 关系选项位于专家选项卡下。

原文由 DPD 发布，翻译遵循 CC BY-SA 3.0 许可协议

Answer 2

嗯，这似乎是一个老问题，但是由于我最近几天一直在搞乱 Doxygen 配置，而我的脑海中仍然充满了当前的信息，让我们试一试 -

我认为以前的答案几乎都有：

缺少的选项是在 Doxyfile 中添加 COLLABORATION_GRAPH = YES 。我假设你可以在 doxywizard GUI 的某个地方做同样的事情（我不使用 doxywizard）。

因此，作为一个更完整的示例，我倾向于使用的与 UML 输出相关的典型“Doxyfile”选项是：

 EXTRACT_ALL          = YES
CLASS_DIAGRAMS      = YES
HIDE_UNDOC_RELATIONS = NO
HAVE_DOT             = YES
CLASS_GRAPH          = YES
COLLABORATION_GRAPH  = YES
UML_LOOK             = YES
UML_LIMIT_NUM_FIELDS = 50
TEMPLATE_RELATIONS   = YES
DOT_GRAPH_MAX_NODES  = 100
MAX_DOT_GRAPH_DEPTH  = 0
DOT_TRANSPARENT      = YES

这些设置将生成“继承”（ CLASS_GRAPH=YES ）和“协作”（ COLLABORATION_GRAPH=YES ）图表。

根据您对 doxygen 输出“部署”的目标，设置 DOT_IMAGE_FORMAT = svg 也可能有用。使用 svg 输出，图表是“可缩放的”，而不是位图格式（如 .png）的固定分辨率。显然，如果在 IE 以外的浏览器中查看输出，还有 INTERACTIVE_SVG = YES 这将允许生成的 svg 图的“交互式缩放和平移”。前段时间我确实尝试过，svg 输出在视觉上非常吸引人，但当时浏览器对 svg 的支持仍然有点不一致，所以希望这种情况最近可能有所改善。

正如其他评论所提到的，其中一些设置（特别是 DOT_GRAPH_MAX_NODES ）确实具有潜在的性能影响，因此 YMMV。

我倾向于讨厌“RTFM”风格的答案，因此为这句话道歉，但在这种情况下，Doxygen 文档确实是您的朋友，所以请查看上述设置中的 Doxygen 文档——上次我查看时，您可以在以下位置找到详细信息 http://www.doxygen.nl/manual/config.html 。

原文由 user6092647 发布，翻译遵循 CC BY-SA 4.0 许可协议