使用Doxygen可高效生成C++项目API文档。首先安装工具并用doxygen -g Doxyfile生成配置文件，接着按JavaDoc等风格编写含@brief、@param、@return的注释，然后在Doxyfile中设置PROJECT_NAME、OUTPUT_DIRECTORY、INPUT等关键选项，最后运行doxygen Doxyfile生成HTML等格式文档，还可集成到Makefile或CI/CD流程中，实现文档自动化维护。
在C++项目中使用Doxygen自动生成API文档，是一种高效、规范的方式，帮助开发者维护代码说明和接口定义。只要按照约定格式书写注释，Doxygen就能解析源码并生成HTML、LaTeX、PDF等多种格式的文档。
安装与配置Doxygen
首先确保系统中已安装Doxygen工具：
- 在Ubuntu/Debian系统中运行：sudo apt-get install doxygen
- 在macOS上可通过Homebrew安装：brew install doxygen
- Windows用户可从官网下载安装包：https://www.doxygen.nl安装完成后，进入项目根目录执行：
doxygen -g Doxyfile
该命令会生成一个默认的配置文件 Doxyfile，你可以手动编辑它来定制输出行为。
编写符合Doxygen规范的注释
Doxygen通过识别特定格式的注释块来提取文档内容。常用风格有JavaDoc和Qt风格。
例如，为一个C++类添加文档：
/**
* @brief 表示一个二维点的类
*
* 该类用于存储和操作平面上的坐标点，
* 支持获取距离、移动位置等操作。
*/
class Point {
public:
/**
* @brief 构造函数
* @param x 初始x坐标
* @param y 初始y坐标
*/
Point(double x, double y);
/**
* @brief 计算到另一个点的距离
* @param other 另一个Point对象
* @return 双精度浮点数，表示欧几里得距离
*/
double distanceTo(const Point& other) const;
private:
double m_x, m_y;
};
函数、变量、命名空间、枚举等都可以用类似方式注释。@brief用于简要描述，@param说明参数，@return描述返回值。
配置Doxyfile关键选项
打开生成的 Doxyfile 文件，调整以下常用设置：
- PROJECT_NAME = "MyCppProject" —— 设置项目名称
- OUTPUT_DIRECTORY = ./docs —— 指定输出目录
- INPUT = ./src —— 指定源码路径（可以是多个）
- RECURSIVE = YES —— 是否递归扫描子目录
- FILE_PATTERNS = *.cpp *.h *.hpp —— 匹配C++文件
- EXTRACT_ALL = YES —— 提取所有函数，即使没有注释
- GENERATE_HTML = YES —— 生成HTML文档
- GENERATE_LATEX = NO —— 不需要PDF时设为NO
- ENABLE_PREPROCESSING = YES —— 启用宏处理（如有条件编译）
保存后，在终端执行：
doxygen Doxyfile
几秒后，./docs/html/index.html 就是生成的主页，用浏览器打开即可查看完整API文档。
集成到构建流程（可选）
为了保持文档同步更新，可将Doxygen加入CI/CD或Makefile中。
例如在Makefile中添加：
doc:
doxygen Doxyfile
运行 make doc 即可一键生成文档。
基本上就这些。只要坚持写规范注释，Doxygen就能帮你自动维护一份清晰的C++ API文档。不复杂但容易忽略的是注释格式和配置细节，一旦设置好，长期受益。
