如何让Doxygen生成Python风格的模块引用格式core.models而非core::models？

方案1：启用Python输出优化 #

在你的Doxyfile中修改配置项：

OPTIMIZE_OUTPUT_JAVA   = NO
OPTIMIZE_OUTPUT_PYTHON = YES

启用OPTIMIZE_OUTPUT_PYTHON后，Doxygen会自动适配Python风格的模块分隔符（.），此时直接使用@ref core.models生成的引用就会显示为core.models，无需额外编写重复的显示文本。

方案2：自定义别名简化引用（兼容现有配置） #

如果不想调整OPTIMIZE_OUTPUT_JAVA的设置，可以在Doxyfile中添加别名定义：

ALIASES += "pyref{1}=@ref \1 "\1""

之后在文档中使用@pyref core.models，就能自动生成显示为core.models的引用，避免手动重复编写模块名称。

补充说明 #

你当前配置中的HIDE_COMPOUND_REFERENCE=YES不会影响上述方案的效果，既能保留完整的模块路径（避免歧义），又能实现Python风格的分隔符显示。针对你使用的Doxygen 1.14.0预发布版本，两种方案均可正常生效。

内容的提问来源于stack exchange，提问作者Isaac Blanc