文档注释 /** @dddd 会触发高亮 */ // 文档注释 /* @dddd 不会高亮 */ // 普通注释 仅当检测到/**时才会启动文档注释的语法分析器,检索@标签并高亮提示。这种设计提高了解析效率,避免对全部注释进行无差别语法分析。 代码模块起始范围声明 /** @defgroup MODULE_NAME 模块描述 * @{ */ ...模块代码内容... /** @} */ // 模块结束标记 @{ 表示开始捕获后续代码作为模块成员,@}表示模块结束。这种设计使得工具能准确提取代码结构生成文档。