doxygen(项目文档生成工具) V1.17.0 官方版

　　doxygen是一款开源的文档生成工具，主要用于从源代码注释中自动生成项目文档。它最初为C++设计，但现已支持C、Java、Python、PHP、C#等多种编程语言。开发者在代码中按照Doxygen约定的格式编写注释（例如使用@param、@return等标签），Doxygen解析源代码和这些注释，生成结构化的技术文档。这大幅降低了维护文档与代码同步的负担。

【功能特色】

　　支持从代码中的特殊格式注释（如/** ... */）提取文档。

　　可生成多种输出格式，包括HTML、LaTeX、RTF、PDF、XML等。

　　自动生成类图、调用关系图、协作图等可视化图表（需安装Graphviz）。

　　支持跨平台（Windows、Linux、macOS）。

【应用场景】

　　生成API参考文档。

　　为开源或企业内部项目提供可浏览的在线文档。

　　辅助代码理解和团队协作。

【使用说明】

　　使用向导和/或专家选项卡配置doxygen，然后切换到运行选项卡生成文档

【标签说明】

　　OUTPUT_DIRECTORY

　　OUTPUT_DIRECTORY 标签用于指定生成文档的（相对或绝对）路径。如果输入相对路径，它将相对于 Doxygen 启动的位置。如果留空，则使用当前目录。

　　DOXYFILE_ENCODING

　　此标签指定配置文件中所有后续字符使用的编码。默认值为 UTF-8，这也是此标签首次出现之前所有文本使用的编码。Doxygen 使用 libiconv（或 libc 中内置的 iconv）进行转码。

　　PROJECT_NAME

　　PROJECT_NAME 标签是一个单词（除非使用 Doxywizard，否则为用双引号括起来的一系列单词），用于标识生成文档的项目。此名称用于大多数生成页面的标题和其他一些地方。

　　默认值为：My Project。

【注意事项】

　　1、注释格式要规范：

　　混用不同注释风格可能导致解析失败，建议统一使用一种风格（如JavaDoc或Doxygen自有风格）。

　　2、编码问题：

　　源文件编码建议设为UTF-8，避免中文乱码。若生成CHM，需设置CHM_INDEX_ENCODING = GB2312。

　　3、路径配置：

　　确保INPUT路径正确，若需递归扫描子目录，设置RECURSIVE = YES。

　　4、图表生成：

　　启用HAVE_DOT = YES并配置Graphviz路径，才能生成类图和调用图。

　　5、未注释代码处理：

　　新手可设EXTRACT_ALL = YES提取未注释代码，但建议逐步规范注释，最终设为NO。