注释保留
当前状态:实现层补充记录。语言级 /// 和 //! 的关联规则,现阶段应优先参考 注释关联规则。
本文只保留 CST 保留注释和 LSP 支持相关的实现说明。
CST 注释支持
Dujie 使用 CST(具体语法树),所有注释都会保留在 Token 流中,并在构建 CST 时关联到对应的语法节点。这为 LSP 功能(悬停提示、代码补全)提供了支持。
注释 Token 类型
词法阶段保留三类注释 token:
///////!
具体关联规则见 注释关联规则,本文不再重复定义语言级注释语义。
LSP 功能支持
保留注释信息为以下 LSP 功能提供了支持: