如何使用DOTGenerator将ANTLR4解析树转换为DOT/Graphviz格式？

我之前也踩过这个坑，找了半天不是ANTLR3的旧资料就是用TreeViewer可视化的方案，完全不符合导出DOT文件的需求。其实ANTLR4的Runtime里就自带了生成DOT格式解析树的工具类，给你一步步说具体操作：

步骤1：确保依赖正确 #

首先确认你的项目里已经引入了ANTLR4的Java Runtime依赖，如果是Maven项目，pom.xml里可以加：

<dependency>
    <groupId>org.antlr</groupId>
    <artifactId>antlr4-runtime</artifactId>
    <version>4.13.1</version> <!-- 建议用最新稳定版 -->
</dependency>

如果是用IntelliJ的ANTLR4插件生成的Lexer和Parser，插件已经帮你配置了基础依赖，这一步可以跳过。

步骤2：获取解析树实例 #

先通过你的Lexer和Parser解析输入文本，得到ParseTree对象，比如假设你的语法起始规则是program：

// 初始化Lexer和Parser
MyGrammarLexer lexer = new MyGrammarLexer(CharStreams.fromString("你的输入文本"));
CommonTokenStream tokens = new CommonTokenStream(lexer);
MyGrammarParser parser = new MyGrammarParser(tokens);

// 获取解析树
ParseTree parseTree = parser.program(); // 这里替换成你自己的起始规则

步骤3：用TreeDOTGenerator生成DOT内容 #

ANTLR4提供了org.antlr.v4.runtime.tree.TreeDOTGenerator类，直接用它生成DOT格式的字符串：

import org.antlr.v4.runtime.tree.TreeDOTGenerator;

// 初始化生成器
TreeDOTGenerator dotGenerator = new TreeDOTGenerator();
// 生成DOT格式文本
String dotContent = dotGenerator.generateDOT(parseTree);

步骤4：保存DOT文件 #

把生成的字符串写入到本地的.dot文件中：

import java.io.FileNotFoundException;
import java.io.PrintWriter;

try (PrintWriter out = new PrintWriter("parse_tree.dot")) {
    out.println(dotContent);
} catch (FileNotFoundException e) {
    e.printStackTrace();
}

步骤5：用Graphviz渲染成图片 #

安装Graphviz工具后，在命令行里执行以下命令，就能把DOT文件转换成PNG（或其他格式）图片：

dot -Tpng parse_tree.dot -o parse_tree.png

注意事项 #

• 确保你的ANTLR4 Runtime版本不低于4.5，TreeDOTGenerator类从这个版本开始就存在了；
• 如果你的解析树包含自定义的节点类型（比如你自己实现了ParseTree的子类），生成器也能正常处理，不需要额外配置；
• 生成的DOT文件可以直接用Graphviz的可视化工具打开，或者在线的Graphviz编辑器预览。

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