运行Verissimo Linter报UNSPECIFIED_TOP警告原因咨询

警告原文 #

***** Warning: UNSPECIFIED_TOP: Please specify a -top module/entity/configuration in the project build file**
该警告字面含义为：未指定顶层，请在项目构建文件中通过-top参数指定待检查的模块、实体或配置项。

触发原因 #

• Verissimo Linter 默认的检查逻辑以指定的顶层模块/实体/配置为入口，梳理整个设计的层次结构、跨模块连接关系后再执行全量规则检查。
• 当构建文件中没有配置-top参数指定顶层，工具也无法自动从当前加载的设计文件里识别出合法顶层时，就会抛出这条警告。
• 即使项目本身没有统一顶层（比如仅维护独立IP、通用组件、公共模块库，不需要做全系统层级的集成检查），工具默认的校验逻辑依然会要求显式配置顶层相关参数，不会因为没有顶层就自动跳过该校验。

无顶层文件场景的处理方案 #

• 针对无统一顶层的组件/IP检查场景，可以在构建配置中把每个待检查的独立模块都配置为顶层，或者传入空的-top参数显式告知工具不需要绑定单一顶层入口，工具就会对所有加载的文件逐个执行独立检查。
• 如果不需要工具做层级关联类检查，也可以直接在规则配置里把UNSPECIFIED_TOP这条告警的等级调整为静默，调整后不会影响其他代码语法、编码规范类规则的正常检查。

内容的提问来源于stack exchange，提问作者Chetan Kumar