Doxygen自动文档生成工具在Eclipse中的集成及使用举例

你有为软件编写说明文档的苦恼吗？当别人甩给你一个庞大的系统，让你根据里面的代码注释理解后写出一份完整的开发文档，你会怎么办？一个个的看代码然后耗时N天来写吗？这既是一份苦差事也极其耗时，有没有更好的办法呢？比如根据代码注释自动生成详尽的说明文档……可能有人会说用Javadoc就是了，要是C/C++、Python、C#等语言写的软件呢？有没有类似Javadoc的东西？

Yes，当然有，Doxygen就是这样一个能满足你需求的工具。Doxygen是一种开源跨平台的，以类似JavaDoc风格描述的文档系统，完全支持C、C++、Java、Objective-C和IDL语言，部分支持PHP、C#。注释的语法与Qt-Doc、KDoc和JavaDoc兼容。Doxgen可以从一套归档源文件开始，可将程序中的特定批注转换成为说明文件，生成HTML格式的在线类浏览器，或离线的LATEX、RTF参考手册。被Boost、OpenCasCade等诸多项目作为文档生成工具的不二选择。

由于我主要的开发语言是Java，所以在这里主要说明Doxygen在Eclipse里的集成及使用步骤。

 

1. 安装doxygen工具

在集成之前需要安装doxygen工具，下载方法有两种：目前最新版是1.8.6

（1）官方网站下载（建议）：Doxygen：Downloads

 （2）在sourceforge下载：Doxygen