產生 C++ 類文檔及關係圖的方法

寫了一大堆的代碼，要產生 C++ 類的文檔及關係圖怎麼辦呢？對，就是產生 MFC 類庫那樣讓人賞心悅目的東西。

總體來說，產生這種文檔有三種思路：

1. 用 Doxygen 來自動產生文檔

   用 Doxygen 可以跨平台，在維護代碼的同時，維護文檔，很方便很實用。

   如果需要產生類的關係圖，可以用 Doxygen 配上 Graphviz，安裝好 Graphviz 後，需要把該可執行目錄添加到系統的 Path 裡，這樣在 Doxygen 裡就可以用 Graphviz 來產生類的關係圖。

   如果是在 vim, Emacs 這類文字編輯器裡，則可以很自然地使用宏操作來插入 Doxygen 注釋；如果是用 Visual Studio 的話呢，也是可以用 DoxyComment add-in for Visual Studio 2005 之類的東西來完成。

   用 Doxygen 來產生文檔有一個要注意的地方，原始碼檔案的編碼和 Doxygen 選用的字元編碼需要一致，否則產生的文檔會亂碼。現在這個年代，當然是統一用 UTF-8 好一點了。

2. 用 Visual Studio 的 Class Diagram

   MSDN 上專門有關於使用 Class Diagram 的介紹。

3. 用 Visio 來畫 UML 圖，純人肉體力活，累，難與代碼同步，不推薦使用。