Doxygen 1.9.2配置双参数自定义Doors关联标签失败求助

问题原因 #

你当前的配置存在两个核心错误：

• 多参数ALIAS定义未用双引号包裹整体，Doxygen无法正确解析包含特殊字符、空格的配置内容
• 定义中没有代入两个入参的占位符（\1对应第一个参数工单编号，\2对应第二个参数Doors链接），自然无法生成预期的链接展示效果

正确配置 #

直接替换你的sw_requirement配置为以下内容即可：

ALIASES += "sw_requirement{2}=@xrefitem sw_requirement \"Requirement(s) under Test\" \"requirement based tests\" <a href=\"\2\">\1</a>"

配置说明 #

• 整段定义用双引号包裹，符合Doxygen ALIAS的语法要求
• 定义内的双引号全部加转义符\，避免截断配置
• \1自动替换为你调用时传入的第一个参数（工单编号，比如示例的TESTID）
• \2自动替换为你调用时传入的第二个参数（Doors链接，比如示例的https://xyz）

可选优化 #

如果你希望在页面上同时明确标识工单号和Doors入口，可以用以下配置，可读性更高：

ALIASES += "sw_requirement{2}=@xrefitem sw_requirement \"Requirement(s) under Test\" \"requirement based tests\" 工单号：<a href=\"\2\">\1</a> | <a href=\"\2\">Doors详情</a>"

注意事项 #

调用标签时，两个参数之间的逗号前后尽量不要加多余空格，避免Doxygen将空格识别为参数内容的一部分导致链接解析错误。

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