工程师 - Doxygen介绍

最新推荐文章于 2025-10-23 15:09:59 发布

原创

最新推荐文章于 2025-10-23 15:09:59 发布 · 876 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#笔记

Code Documentation.

Automated.

Free, open source, cross-platform.

Version 1.12.0 is now available! Release date: 7 August 2024

官方网址：

Doxygen homepage

文档：

Doxygen: Overview

Github网址：

https://github.com/doxygen/doxygen

下载并安装Windows 64bit版的安装文件doxygen-1.12.0-setup.exe。

Doxygen 是软件开发中广泛使用的文档生成工具。它能根据源代码注释自动生成文档，解析有关类、函数和变量的信息，生成 HTML 和 PDF 等格式的输出。通过简化和标准化文档流程，Doxygen 加强了不同编程语言和项目规模之间的协作和维护。

Doxygen is a widely-used documentation generator tool in software development. It automates the generation of documentation from source code comments, parsing information about classes, functions, and variables to produce output in formats like HTML and PDF. By simplifying and standardizing the documentation process, Doxygen enhances collaboration and maintenance across diverse programming languages and project scales.

Multiple output formats

Doxygen 可以生成各种输出格式的文档，如 HTML、PDF（通过 LaTeX）、Word（通过 RTF）和 XML。

这种灵活性允许开发人员选择最适合自己需要的格式，或将文档集成到不同的系统中。

Doxygen can generate documentation in various output formats, such as HTML, PDF (via LaTeX), Word (via RTF), and XML.

This flexibility allows developers to choose the format that best suits their needs or integrate the documentation into different systems.

Markdown

Doxygen 中的 Markdown 支持可以让您将 Markdown 的简洁性与 Doxygen 的强大功能相结合，用于描述代码。

除了 Markdown 之外，Doxygen 还支持许多命令，如 \param、\return、\brief 等，以提供有关函数、参数和返回值的附加信息。

Markdown support in Doxygen allows you to combine the simplicity of Markdown with the powerful features of Doxygen for documenting code.

Next to Markdown, Doxygen supports many commands like \param, \return, \brief, etc., to provide additional information about functions, parameters, and return values.

Doxygen: Markdown support

C++

Doxygen provides robust support for documenting C++ code, recognizing the intricacies of the language and generating comprehensive documentation.

Next to C++, Doxygen also supports C, Python, PHP, Java, C#, Objective-C, Fortran, VHDL, Splice, IDL, and Lex.

Doxygen 为记录 C++ 代码提供了强大的支持，能够识别语言的复杂性并生成全面的文档。
除 C++ 外，Doxygen 还支持 C、Python、PHP、Java、C#、Objective-C、Fortran、VHDL、Splice、IDL 和 Lex。

Cross-referencing

Doxygen 提供交叉引用功能，允许用户在文档的不同部分之间进行导航。

Doxygen 会生成指向相关元素的超链接，方便用户探索代码库并了解不同组件之间的关系。

Doxygen provides cross-referencing capabilities, allowing users to navigate between different parts of the documentation.

Doxygen generates hyperlinks to related elements, making it easy to explore the codebase and understand the relationships between different components.

Diagrams

Doxygen 可以生成图形化的类层次结构和协作图，为类和函数之间的关系提供可视化概览。

Doxygen can generate graphical representations of class hierarchies and collaboration diagrams, providing a visual overview of the relationships between classes and functions.

Configuration

Doxygen 提供一个配置文件（Doxyfile），允许用户自定义文档生成过程。您可以控制各种设置，如输出格式、文件包含/排除等。

Doxygen provides a configuration file (Doxyfile) that allows users to customize the documentation generation process. You can control various settings, such as the output format, file inclusion/exclusion, and more.

Changelog（种类）

Deprecated functionality

Removed functionality
Refactoring and cleanup
New features
Bug fixes
Improved testing and debugging
Improved user feedback and documentation
Minor incompatibilities

安装时显示的License LGPL-2.0：

GNU 库通用公共许可证 v2.0 - GNU 工程 - 自由软件基金会

GNU GENERAL PUBLIC LICENSE

Version 2, June 1991

51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Everyone is permitted to copy and distribute verbatim copies

of this license document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your

freedom to share and change it. By contrast, the GNU General Public

License is intended to guarantee your freedom to share and change free

software--to make sure the software is free for all its users. This