Doxygen中\link与\ref命令是否存在功能差异？

两者功能高度重叠，但并非完全一致，核心差异体现在语法形式和官方推荐性上：

• 语法使用差异

  • \ref 支持两种写法：直接引用目标（如 \ref my_class，自动用目标名称作为链接文本），或自定义链接文本（如 \ref my_class "查看这个类的定义"），无需闭合标记，语法更简洁。
  • \link 必须配合 \endlink 使用，链接文本放在两者之间（如 \link my_class 查看这个类的定义 \endlink），语法上相对繁琐。

• 官方定位差异
  Doxygen官方文档中，\link属于较早的命令，而\ref是后续推出的替代方案，功能上完全覆盖\link，且更灵活。官方更推荐在新代码中使用\ref。

• 实际功能一致性
  不管用哪种命令，最终生成的文档链接效果完全相同，都能跳转到指定的代码元素（函数、类、宏等）或文档章节。

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