注释保留

当前状态:实现层补充记录。语言级 /// 和 //! 的关联规则,现阶段应优先参考 注释关联规则。 本文只保留 CST 保留注释和 LSP 支持相关的实现说明。

CST 注释支持

Dujie 使用 CST(具体语法树),所有注释都会保留在 Token 流中,并在构建 CST 时关联到对应的语法节点。这为 LSP 功能(悬停提示、代码补全)提供了支持。

注释 Token 类型

词法阶段保留三类注释 token:

  • //
  • ///
  • //!

具体关联规则见 注释关联规则,本文不再重复定义语言级注释语义。

LSP 功能支持

保留注释信息为以下 LSP 功能提供了支持:

悬停提示 - 从 CST 节点的 comments 字段提取文档注释

代码补全 - 利用文档注释提供智能补全

文档生成 - 自动生成 API 文档

代码导航 - 利用注释信息提供更好的导航体验