class Prism::ParseResult::Comments

当我们解析完源代码后,我们会同时得到语法树和在源代码中找到的注释列表。此类负责遍历语法树并找到每个注释应该附加到的最近位置。

它是通过首先为每个注释找到最近的位置来完成的。位置可以来自节点本身,也可以来自节点上的位置字段。例如,一个 ClassNode 有一个包含整个类的整体位置,但也有一个表示 class 关键字的位置。

一旦找到最近的位置,它就会决定附加到哪个位置。如果它是行尾注释(与源代码在同一行的注释),它将倾向于附加到位于注释之前的最近位置。否则,它将倾向于附加到位于注释之后的最近位置。