如何在Doxygen中禁用自动链接？附代码示例及XML生成情况

要让Doxygen停止自动解析注释里的链接并生成ulink标签，你可以从全局配置、局部控制或者字符转义这几个方向入手，具体方法如下：

方法1：全局禁用自动链接（推荐） #

直接修改你的Doxygen配置文件（Doxyfile），设置两个关键选项：

• AUTOLINK_SUPPORT = NO：这是核心开关，关闭后Doxygen不会自动识别URL并将其转换为任何链接标签，包括XML里的ulink。
• MARKDOWN_SUPPORT = YES（可选）：如果你还需要保留其他Markdown语法的解析支持，保持这个选项开启即可——关闭AUTOLINK_SUPPORT后，Doxygen不会解析Markdown格式的链接，会原样保留到XML输出中。

修改后重新生成文档，XML里的链接内容就会和你注释里写的一致了。

方法2：局部禁用特定内容的自动链接 #

如果你只想让某部分注释内容不被自动链接处理，而全局保持自动链接功能，可以用\verbatim命令包裹目标内容：

/**
 * 这段文本的自动链接仍然生效（如果全局开启的话）。
 * \verbatim
 * 这里是一个内联链接 [test](http://www.test.com)。
 * 更多信息：
 * <a href="http://www.test.com">test</a>
 * \endverbatim
 */

注意：\verbatim会把内容标记为预格式化文本，生成的XML里会放在<programlisting>标签中，后续转换Markdown时需要单独处理这个标签。

方法3：转义特殊字符实现内联保留 #

如果想在段落内直接保留Markdown链接格式，不使用块级标签，可以转义链接里的特殊字符，让Doxygen不解析它们：

/**
 * 这里是一个内联链接 \[test\]\(http://www.test.com\)。
 * 更多信息：
 * <a href="http://www.test.com">test</a>
 */

这样Doxygen会把转义后的内容原样输出到XML中，你后续在转换脚本里去掉反斜杠，就能恢复成标准的Markdown链接了。

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