antlr4-dev

whtoo's avatarfrom whtoo

ANTLR4前端开发专家,专注于词法/语法分析、AST构建、访问者模式实现。

⭐32stars🔀5forks📁View on GitHub🕐Updated Dec 28, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill is a specialized expert in ANTLR4 frontend development, focusing on the end-to-end pipeline of language processing. It provides comprehensive support for designing lexer and parser rules, constructing Abstract Syntax Trees (AST), and implementing the Visitor pattern. By automating the integration of grammar files with Java projects and offering debugging strategies for complex syntax conflicts, it significantly accelerates the development of compilers and domain-specific languages (DSLs).

Use Cases

  • 1. Custom DSL Development: Designing and implementing Domain Specific Languages by creating .g4 grammar files and generating corresponding parsers for specialized business logic.
  • 2. Compiler Frontend Engineering: Building the initial stages of a compiler, including lexical analysis, syntactic analysis, and the creation of structured AST nodes.
  • 3. Grammar Debugging & Optimization: Identifying and resolving common grammar issues such as left recursion, ambiguities, and non-determinism using diagnostic tools and Maven workflows.
  • 4. Static Code Analysis Tools: Implementing the Visitor pattern to traverse ASTs for the purpose of building code linters, security scanners, or automated refactoring scripts.
nameantlr4-dev
descriptionANTLR4前端开发专家,专注于词法/语法分析、AST构建、访问者模式。
versionv1.0
tags[antlr4, frontend, lexer, parser, ast]
allowed-toolsmcp__serena__search_for_pattern, mcp__serena__find_symbol, Read, Bash
requires-skills[ep-navigator]

ANTLR4前端开发

🎯 垂直职责

单一职责: ANTLR4语法设计、词法/语法分析、AST构建、访问者模式

📦 核心能力

1. 语法文件开发

  • 位置: ep20/src/main/antlr4/org/teachfx/antlr4/ep20/parser/Cymbol.g4
  • 语法结构: lexer规则 → parser规则 → AST构建
  • 重新生成: mvn generate-sources -pl ep20

2. AST节点实现

  • 基类: ASTNode.java (位于 ep20/src/main/java/org/teachfx/antlr4/ep20/ast/)
  • 模式: 访问者模式 accept(ASTVisitor<T>)
  • 扩展: 创建新节点继承 ExprNode / StmtNode

3. 访问者模式

// 新节点标准实现
public class NewStmtNode extends StmtNode {
    private final Type field;

    public NewStmtNode(Type field) {
        this.field = field;
    }

    @Override
    public <T> T accept(ASTVisitor<T> visitor) {
        return visitor.visitNewStmt(this);
    }
}

🔗 关系图

→ ep-navigator (识别EP范围) ← compiler-dev (AST → IR转换)

🚀 快速开始

添加新语法特性

# 1. 编辑 Cymbol.g4
vim ep20/src/main/antlr4/.../parser/Cymbol.g4

# 2. 重新生成解析器
mvn generate-sources -pl ep20

# 3. 创建AST节点
vim ep20/src/main/java/.../ast/NewNode.java

# 4. 更新AST构建器
vim ep20/src/main/java/.../pass/ast/CymbolASTBuilder.java

# 5. 测试
mvn test -pl ep20 -Dtest="*ParserTest"

调试语法冲突

# 使用TestRig可视化语法树
java -cp "antlr-4.13.2-complete.jar:ep20/target/classes" \
  org.antlr.v4.gui.TestRig Cymbol file -gui test.cymbol

# 诊断冲突
mvn generate-sources -pl ep20 -Xantlr4.show-dfa

📚 Cymbol语法速查

类型 规则 示例
变量声明 declaration int x;
函数定义 functionDef int add(int a, int b) { ... }
结构体 structDef struct Point { int x; int y; }
数组 type '[' expr? ']' int[10] arr;
控制流 ifStmt / whileStmt if (x > 0) { ... }

🛠️ 常用命令

# 语法相关
mvn generate-sources -pl ep20              # 重新生成解析器
mvn test -pl ep20 -Dtest="*Lexer*"         # 测试词法
mvn test -pl ep20 -Dtest="*Parser*"        # 测试语法

# AST相关
mvn test -pl ep20 -Dtest="*AST*"           # 测试AST构建
mvn test -pl ep20 -Dtest="*Visitor*"       # 测试访问者

# 完整前端
mvn compile -pl ep20 && mvn test -pl ep20  # 编译并测试前端

⚠️ 常见问题

问题 原因 解决方案
语法冲突 左递归/歧义 重构规则,使用语义谓词
AST未生成 忘记运行generate-sources mvn generate-sources -pl ep20
访问者空指针 新节点未实现accept() 添加 accept(ASTVisitor<T>)

版本: v1.0 | 垂直职责: ANTLR4前端 | 2025-12-23