写了一大堆的代码，要生成 C++ 类的文档及关系图怎么办呢？对，就是生成 MFC 类库示意图那样让人赏心悦目的东西。

总体来说，生成这种文档有三种思路：

  1. 用 Doxygen 来自动生成文档 用 Doxygen 可以跨平台，在维护代码的同时，维护文档，很方便很实用。
如果需要生成类的关系图，可以[用 Doxygen 配上 Graphviz](http://www.stack.nl/~dimitri/doxygen/diagrams.html)，安装好 [Graphviz](http://www.graphviz.org/) 后，需要把该可执行目录添加到系统的 Path 里，这样在 Doxygen 里就可以用 Graphviz 来生成类的关系图。

如果是在 vim, Emacs 这类文本编辑器里，则可以很自然地[使用宏操作来插入 Doxygen 注释](http://blog.waterlin.org/articles/emacs-yasnippet-basic-usage.html)；如果是用 Visual Studio 的话呢，也是可以用 [DoxyComment add-in for Visual Studio 2005](http://doxycomment.sourceforge.net/vs2005_addin.html) 之类的东西来完成。

用 Doxygen 来生成文档有一个要注意的地方，源代码文件的编码和 Doxygen 选用的字符编码需要一致，否则生成的文档会乱码。现在这个年代，当然是统一用 UTF-8 好一点了。

  1. 用 Visual Studio 的 Class Diagram MSDN 上专门有关于使用 Class Diagram 的介绍。

  2. 用 Visio 来画 UML 图，纯人肉体力活，累，难与代码同步，不推荐使用。