VS Code Extensions
Doxygen Ref Navigator

Doxygen Ref Navigator

by launcher

Highlight @ref and @arg targets in comments and jump to matching Doxygen or C definitions.

Downloads

22

Rating

— (0)

Version

0.1.4

Last updated

Aug 21, 2026

在注释中为 @ref ADC_Sequence、@arg USART_PARITY_NONE 这类 Doxygen 引用提供链接样式、高亮和跳转能力。

功能

  • 把 @ref ADC_Sequence、@arg USART_PARITY_NONE 中的目标名称渲染成可识别的链接样式
  • 支持 Ctrl+Click / F12 / 右键 Go to Definition
  • 从 @ref xxx 跳到工作区内对应的 @defgroup xxx 或 C 类型定义
  • 从 @arg xxx 跳到工作区内对应的 #define 宏或枚举成员定义
  • 支持同名 @defgroup 多处定义,VS Code 会进入候选列表
  • 支持跳转到常见 C 类型定义,例如 typedef struct { ... } stc_xxx_t;、typedef enum { ... } en_xxx_t;、struct xxx { ... };
  • 提供命令 Doxygen Ref Navigator: Rebuild Index 用于手动重建索引
  • 状态栏会显示当前索引状态和进度,点击可手动重建索引

适用文件

默认只索引以下后缀文件,以减少扫描范围并提升速度:

  • .c
  • .h

适配说明

  • 当前实现会建立 @ref <name> 到 @defgroup <name>/常见 C 类型定义的关联,以及 @arg <name> 到宏/枚举成员定义的关联
  • 若工作区中存在多个同名 @defgroup,定义跳转会返回多个位置
  • 若工作区中存在多个同名目标,定义跳转会返回多个位置
  • 索引会在文件打开、编辑、保存以及文件系统变更时自动更新

Related extensions