C#项目集成ANTLR4遇阻：添加ANTLR3及语法文件后无法构建

兄弟，你这问题十有八九是ANTLR3和ANTLR4在同一个项目里“打架”了！毕竟这俩版本的工具链、代码生成逻辑和依赖完全不兼容，同时引入肯定会搞崩构建流程。下面给你一步步捋清楚怎么修复：

一、先搞懂核心冲突点 #

ANTLR3和ANTLR4根本不是一路人：

• 你之前用ANTLR4生成的ECMAScript相关类，全是基于ANTLR4的Runtime API；而ANTLR3的JSDeobfusc.g会生成依赖ANTLR3 Runtime的代码，两者的包名、类名甚至方法都有重叠，编译时直接就冲突炸了。
• 不管你用Maven还是Gradle，默认的ANTLR插件只能处理一个版本的语法文件，同时喂给它俩版本的语法，插件直接懵圈，自然生成不了词法/语法分析器。

二、具体修复步骤 #

1. 先把两个版本的语法文件隔离开 #

把ECMAScript.g4和JSDeobfusc.g放到项目里完全独立的目录，比如：

• src/main/antlr4/com/yourproj/antlr4 专门放ANTLR4的语法文件
• src/main/antlr3/com/yourproj/antlr3 专门放ANTLR3的语法文件

2. 给构建工具配置两个独立的插件实例（以Maven为例，Gradle同理） #

在pom.xml里分别配置ANTLR3和ANTLR4的插件，让它们各自处理自己目录下的文件：

<!-- 处理ANTLR4语法的插件 -->
<plugin>
    <groupId>org.antlr</groupId>
    <artifactId>antlr4-maven-plugin</artifactId>
    <version>4.13.1</version>
    <executions>
        <execution>
            <id>antlr4-gen</id>
            <goals>
                <goal>antlr4</goal>
            </goals>
            <configuration>
                <sourceDirectory>src/main/antlr4</sourceDirectory>
                <outputDirectory>target/generated-sources/antlr4</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

<!-- 处理ANTLR3语法的插件 -->
<plugin>
    <groupId>org.antlr</groupId>
    <artifactId>antlr3-maven-plugin</artifactId>
    <version>3.5.2</version>
    <executions>
        <execution>
            <id>antlr3-gen</id>
            <goals>
                <goal>antlr</goal>
            </goals>
            <configuration>
                <sourceDirectory>src/main/antlr3</sourceDirectory>
                <outputDirectory>target/generated-sources/antlr3</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

这样两个插件各干各的，生成的代码也会放在不同目录，不会互相干扰。

3. 把两个版本的Runtime依赖都配齐 #

在pom.xml里同时引入ANTLR3和ANTLR4的Runtime，注意版本要对应：

<!-- ANTLR4运行时依赖 -->
<dependency>
    <groupId>org.antlr</groupId>
    <artifactId>antlr4-runtime</artifactId>
    <version>4.13.1</version>
</dependency>

<!-- ANTLR3运行时依赖 -->
<dependency>
    <groupId>org.antlr</groupId>
    <artifactId>antlr-runtime</artifactId>
    <version>3.5.2</version>
</dependency>

4. 清理旧文件，重新构建 #

• 先手动删掉之前生成的ANTLR相关类（比如target目录下generated-sources里的文件，或者IDE里的generated文件夹）
• 然后执行mvn clean install（Maven）或者gradle clean build（Gradle），彻底清理后重新生成代码

5. 排查路径相关的编译错误 #

如果还是出现类似File 'C:\Users\D...的错误，大概率是这几个原因：

• JSDeobfusc.g里有没有硬编码的文件路径？检查一下语法文件里的配置
• 构建输出目录权限不够，导致无法生成文件，试试以管理员身份运行IDE或构建命令
• IDE缓存搞鬼，重启IDE并重新导入项目试试

三、额外建议：尽量统一用ANTLR4 #

如果不是非用ANTLR3不可，建议把JSDeobfusc.g转换成ANTLR4的.g4格式，这样整个项目只用ANTLR4，能省掉一堆版本兼容的麻烦。转换的时候主要是调整语法规则的写法，移除ANTLR3特有的配置（比如旧的options设置）就行。

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