在统信UOS中生成C/C++/Java源码API文档，需先安装Doxygen和可选Graphviz，生成并配置Doxyfile，再执行doxygen命令生成HTML文档。

在统信UOS系统中生成C/C++/Java等源码的API文档，必须先安装Doxygen工具并完成基础配置，否则无法从注释中提取结构化文档。

安装Doxygen与Graphviz

统信UOS默认未预装Doxygen，需通过终端命令安装核心工具及可选图表支持组件。

打开终端，执行以下命令安装Doxygen主程序：

sudo apt update && sudo apt install doxygen

若需生成类图、调用图等可视化图表，必须额外安装Graphviz：

sudo apt install graphviz

【Graphviz安装后必须重启终端或重新登录用户，否则doxygen配置中DOT_PATH将无法自动识别dot命令路径】

验证安装是否成功：

doxygen --version && dot -V

两条命令均应输出版本号，无报错即表示环境就绪。

生成并编辑Doxyfile配置文件

Doxygen不依赖图形界面运行，所有行为由Doxyfile文本配置文件驱动，首次使用必须生成该文件。

进入你的代码根目录（例如 ~/myproject），执行：

doxygen -g

该命令会在当前目录生成默认配置文件 Doxyfile。注意：此文件名区分大小写，不可改名。

用文本编辑器打开 Doxyfile，重点修改以下三处：

INPUT = ./src → 改为实际源码所在子目录路径，如代码在当前目录下则填 .

PROJECT_NAME = "MyProject" → 替换为你的项目名称，中文需确保系统locale支持UTF-8

GENERATE_HTML = YES → 确保此项为YES，否则不会生成网页版文档

如需生成LaTeX PDF文档，还需将 GENERATE_LATEX 设为 YES，并确认系统已安装texlive-full（UOS应用商店可搜“TeX Live”安装）。

运行Doxygen生成文档

保存 Doxyfile 后，在同一目录下直接执行：

doxygen

Doxygen开始扫描源码、解析注释、生成HTML和搜索索引。首次运行耗时取决于代码量，通常几秒到数分钟。

生成结果默认存放在 html/ 子目录中，打开 index.html 即可浏览完整文档。

若提示 “warning: character 0xXXXX cannot be represented in the current encoding”，说明源码中含非UTF-8编码注释，需用 iconv 或编辑器统一转为UTF-8再运行。

后续每次修改源码注释后，只需再次执行 doxygen 命令即可增量更新文档，无需重新配置。