如何为ANTLR4生成的Java解析器添加导入语句以在语义谓词中使用外部类

不需要依赖同包转发类的hack写法，直接使用ANTLR4原生支持的语法动作块即可实现需求。

核心实现步骤 #

在你的.g4语法文件的全局配置区，通过@header块指定需要自动生成的import语句。ANTLR4在生成Java代码时，会将@header块内的内容原封不动插入到生成解析器类的头部对应位置。
参考写法示例：

// 原有语法声明
grammar YourGrammar;

// 新增全局头部配置
@header {
import my.otherpackage.OtherClass;
}

// 原有规则无需改写，可直接调用OtherClass
somerule : { OtherClass.test(_input.LT(1).getText()) }? Token ;

关键注意事项 #

• @header块内的import语句会同时作用于生成的解析器和词法器类。如果只需要在解析器中添加导入，可替换为@parser::header块，对应的导入内容只会写入生成的解析器文件
• 需要导入多个类时，直接在块内按普通Java语法换行编写多句import即可，无特殊格式要求
• 不要将生成类的包声明写到@header块中，包名需要通过专门的@parser::package、@lexer::package块配置，否则会生成格式错误的Java代码

关于现有转发类方案的说明 #

你当前使用的同包转发类实现属于冗余hack：

新增的转发类没有实际业务逻辑，仅做一层方法透传。后续如果目标类的方法签名调整，需要同步修改转发类的代理代码，产生无意义的维护成本。
使用原生@header配置后，可完全移除这层转发代码，直接在语义谓词中调用目标类方法。

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