ANTLR v4 安装和hello world运行环境避坑指南

首先,你需要下载Java运行环境的JDK和JRE,以及lib

• Java SE Development Kit 8u211
• Java SE Runtime Environment 8u211
• antlr-4.7.2-complete.jar

在D盘新建目录Java,结构如下:

Java

├ Javalib       存放antlr-4.7.2-complete.jar

├ JDK            安装JDK路径

└ JRE            安装JRE路径

设置如下系统变量:

变量名	变量值	说明
CLASSPATH	.;D:\Java\Javalib\antlr-4.7.2-complete.jar;%CLASSPATH%	注意一定要带".;",这是为了保证类库可以在任何目录下使用
JAVA_HOME	D:\Java\JDK	设置Java目录
Path	D:\Java\JDK\bin;D:\Java\JDK\jre\bin;D:\Java\Javalib	注意这里是附加在最末尾

进入目录D:\Java\Javalib,新建如下两个批处理

antlr4.bat

java -cp antlr-4.7.2-complete.jar org.antlr.v4.Tool %*

grun.bat

@ECHO OFF
SET TEST_CURRENT_DIR=%CLASSPATH:.;=%
if "%TEST_CURRENT_DIR%" == "%CLASSPATH%" ( SET CLASSPATH=.;%CLASSPATH% )
@ECHO ON
java org.antlr.v4.gui.TestRig %*

在cmd下运行如下命令(注意一定是cmd不是powershell)

doskey antlr4=java org.antlr.v4.Tool $*
doskey grun=java org.antlr.v4.gui.TestRig $*

验证是否配置成功

在cmd中分别键入java和javac,如果正确返回帮助列表则证明成功

 

其他说明:

在官方文档中可以测试Hello.g4这个语法文件

https://github.com/antlr/antlr4/blob/master/doc/getting-started.md

执行时如果antlr4命令找不到,需要把antlr-4.7.2-complete.jar,antlr4.bat和grun.bat放到Hello.g4同目录下,然后用批处理执行编译

如果执行时报错语法名与文件名不一致, 要注意执行文件时文件名大小写要完全一致,例如:

antlr4.bat Hello.g4

测试运行命令

• antlr4 Hello.g4
• javac Hello*.java
• grun Hello r -gui

末尾的" r -gui"参数意为在执行完语法分析后弹出语法分析树

注意!!!如果想使用中文,请务必将*.g4文件使用ANSI编码,否则中文无法识别