编译Java时ANTLR4导入CharStreams报cannot find symbol错误的原因

这个cannot find symbol报错的本质，是你编译环境里加载到的ANTLR Runtime版本过低。
org.antlr.v4.runtime.CharStreams这个类是从ANTLR 4.7.0版本才正式加入Runtime依赖包的，在更早的4.5.x、4.6.x等老版本里根本没有这个类。而你代码里用到的CharStream、CommonTokenStream、ParseTree这些类是ANTLR 4全版本都保留的基础类，所以这些类的导入完全不会报错，唯独CharStreams会提示找不到符号——这也刚好对应你判断的“类路径配置没问题”的感受：类路径本身没有配错，只是路径上加载到的Runtime jar包里缺了这个特定的类。

排查与修复方案 #

• 第一步先核对实际生效的ANTLR Runtime版本
  • 手动配置classpath的场景，直接查看你引用的antlr-runtime-*.jar的文件名版本号
  • 用Maven/Gradle等构建工具的场景，拉取依赖树，确认有没有其他依赖传递引入了低版本的ANTLR，把你自己指定的高版本给覆盖了
• 按你的实际版本场景选择对应修复方式：
  • 如果你是用ANTLR 4.7.0及以上版本的工具生成的GrammarLexer、GrammarParser、Visitor这些类，把编译用的Runtime包版本完全对齐到代码生成的版本，确保这个版本的jar包里确实包含CharStreams类即可
  • 如果你必须使用4.7.0之前的低版本Runtime，直接替换代码实现就能解决：
    • 删掉代码里import org.antlr.v4.runtime.CharStreams;这行导入
    • 把原来写的CharStream input = CharStreams.fromFileName(file);，替换成老版本兼容的实现：CharStream input = new ANTLRFileStream(file);，这个类在所有老版本ANTLR的org.antlr.v4.runtime包下，和CharStream接口完全兼容，不需要改动其他代码
  • 额外注意classpath的加载顺序：如果本地同时存了多个版本的ANTLR Runtime jar，要保证匹配代码版本的jar路径排在最前面，避免类加载器优先读取到老版本的jar包，再次触发找不到类的报错。

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