在注释中为 @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,定义跳转会返回多个位置 - 若工作区中存在多个同名目标,定义跳转会返回多个位置
- 索引会在文件打开、编辑、保存以及文件系统变更时自动更新