精通ast-grep

版权信息

书名：精通AST-GREP

本书由人民邮电出版社发行数字版。版权所有，侵权必究。

您购买的人民邮电出版社电子书仅供您个人使用，未经授权，不得以任何方式复制和传播本书内容。

我们愿意相信读者具有这样的良知和觉悟，与我们共同保护知识产权。

如果购买者有侵权行为，我们可能对该用户实施包括但不限于关闭该帐号等维权措施，并可能追究法律责任。

版  权

著    锈儿海老师（Herrington Darkholme）

责任编辑 傅道坤

人民邮电出版社出版发行　　北京市丰台区成寿寺路11号

邮编　100164 　电子邮件　315@ptpress.com.cn

网址　http://www.ptpress.com.cn

读者服务热线：(010)81055410

反盗版热线：(010)81055315

内 容 提 要

本书主要介绍了基于Rust开发的高性能工具ast-grep的核心原理、使用方法与进阶技巧，涵盖结构化代码搜索、代码扫描（Linting）及重构等核心应用场景，解决了传统文本工具精度不足与AST查询接口上手困难的痛点。

本书分为四个主要部分。入门篇介绍ast-grep工具定位、抽象语法树（AST）与解析器基础、tree-sitter底层支持及快速上手，帮助读者建立核心认知；基础篇详解模式匹配、元变量、YAML规则编写、节点类型匹配、正则应用、关系与逻辑规则及基础代码重写，助力掌握核心操作；中级篇聚焦带上下文的模式优化、关系规则细化、工具规则复用、元变量约束、项目配置、规则测试、编辑器集成、在线调试及AI协同应用，提升实践能力；高级篇深入模式语法与匹配算法、高级修复与元变量转换、自定义标签、API与CLI高级功能、自定义语言及嵌入式代码处理，同时说明工具局限性，满足深度定制需求。

本书适合具备至少一种编程语言实际使用经验，希望精通结构化代码搜索、扫描与转换的开发者、工程师、代码重构爱好者，以及需要进行大规模代码管理、规则开发的库作者和工具开发者阅读。

推荐序
结构化思维：AI时代开发者的"进化武器"

我在高性能工具链与跨语言生态领域深耕多年，始终秉持一个核心准则：卓越的工具不仅是问题的解决方案，更应成为重新定义效率边界的核心驱动力。

初识ast-grep时，我正投身于napi-rs项目的构建工作，致力于破除Node.js开发者调用Rust原生能力时面临的技术壁垒。作为ast-grep的早期赞助者，我被其创作者海老师（Herrington Darkholme）所展现的技术愿景深深打动——他并非仅在开发一款更快的搜索工具，而是在打造一套能够深度理解代码语义、精准操控代码结构的"技术手术刀"。

从工具基石到生态交汇

在技术架构层面，ast-grep与我的技术实践有着深厚的渊源。它以napi-rs作为跨语言集成的核心基石，这一选择使其在保有Rust语言极致性能优势的同时，能够无缝融入前端开发者熟悉的技术生态。这种对底层性能优化与上层易用性体验的双重追求，与我多年来倡导的"Node-API革命"理念不谋而合。

这种技术层面的契合与互信，在AI时代进一步生根结果。在我近期主导的mlx-node项目（一款为Node.js生态提供GPU加速深度学习能力的框架）中，我们正借助其强大的推理与训练能力，对模型进行针对性微调（Fine-tuning）。我们的目标清晰而明确：让模型深度学习并掌握ast-grep的语法逻辑与使用规则，从而能够更高效、精准地自动生成符合需求的ast-grep规则。这种将高性能深度学习框架与结构化代码工具相结合的探索，正是为了突破大规模代码治理的效率极限。

AI浪潮下的"双重增幅器"

站在2026年这一AI技术深刻重塑软件开发范式的关键节点，ast-grep的技术价值正实现质的跃迁。

在前AI时代，它是大型项目架构迁移与技术升级的"破冰利器"。当我们需要从传统框架迁移至新范式，或在千万行级别的庞大代码库中精准定位脆弱的反模式时，ast-grep摆脱了传统grep工具盲目匹配、噪声繁多的弊端，实现了"所见即所得"的结构化代码改写，大幅降低了大规模代码重构的难度与风险。

在后AI时代，它成为AI技术效能的"倍增器"与"矫正器"。尽管AI能够快速生成代码，但大语言模型（LLM）的输出往往存在随机性与"幻觉"问题，难以直接满足工程化要求。而ast-grep可作为AI产出的自动化质检机制（Guardrail），通过预设的YAML规则，强制规范AI生成代码的结构与风格，确保其符合工程严谨性标准；同时，借助ast-grep精准提取的代码片段，能够为LLM提供更高质量的上下文信息（Context），推动AI辅助编程从"概率猜测"向"精准推演"跨越。

为什么要读这本书

本书作者不仅是ast-grep的核心创作者，更是开源社区中少有的兼具底层技术研发能力与上层工程实践经验的专家。书中系统梳理了从抽象语法树（AST）基础概念到复杂重构规则设计的完整进阶路径，构建了一套逻辑严密、可落地的"结构化思维"模型。无论你是希望通过Rust语言提升工具链性能的开发者，还是正在探索AI技术赋能大规模代码治理的架构师，都能从书中获得极具价值的实践指导与思维启发。

在Void Zero团队，我们始终致力于打造下一代AI集成式开发者工具链。而我坚信，ast-grep正是这套未来工具链中不可或缺的语义引擎。愿每一位读者都能通过本书，熟练掌握这把在大规模代码海洋中游刃有余的"解牛利刃"，在AI时代的技术浪潮中实现能力进阶与价值提升。

Brooooooklyn太狼

Void Zero成员、napi-rs创作者、mlx-node发起人

作者简介

锈儿海老师（Herrington Darkholme），拥有多年Web开发与工具链领域深耕经验，尤其擅长通过Rust和TypeScript构建高性能前端基础设施，长期致力于利用Rust语言对Web前端工具链进行重构与性能优化。当前自主创建并维护知名项目ast-grep，同时作为Element Plus核心团队成员深度参与开源社区建设；曾参与Vue模板编译器的Rust重写工作，为Vue.js生态发展发挥关键作用；还积极投身于高性能构建工具Rspack的生态贡献，助力前端基础设施升级。平时专注于技术深耕与开源项目迭代，持续为Web开发领域输出高质量工具与技术实践成果。

前  言

在软件开发迈入规模化、多语言协同的今天，代码库的量级与复杂度呈指数级增长，开发者面临的核心痛点日益凸显：传统文本搜索工具（如grep）精度不足，易受语法变体干扰导致误报；编译器API或原生抽象语法树（AST）查询接口门槛过高，普通开发者难以快速上手；跨语言代码管理、批量重构、自动化扫描等场景缺乏高效且易用的工具支撑。

在此背景下，基于AST的结构化代码处理技术应运而生，而ast-grep作为一款由Rust开发的高性能工具，凭借多语言支持、极致性能与渐进式使用体验，成功填补了传统工具与专业接口之间的空白，成为大规模代码搜索、扫描（Linting）与重构的优选方案。

然而，当前行业内关于ast-grep的系统教程相对匮乏，多数开发者仅能通过零散文档或官方示例摸索使用，难以深入掌握其核心原理与高级特性，导致工具的强大潜力未能充分释放。基于此，我们结合大量实践经验与技术沉淀，编写了这本全面、系统的教程，旨在为不同层次的开发者搭建从入门到精通的学习路径，帮助读者真正掌握结构化代码处理的核心逻辑与实用技巧。

本书组织结构

这是一本兼顾原理与实践的技术教程，遵循“从基础到进阶、从理论到应用”的认知规律，帮助读者系统构建专业知识体系。

入门篇：夯实概念基础

本篇章聚焦核心原理科普，解答“为什么结构化搜索是代码操作的正确选择”这一核心问题，内容涵盖：基于文本的搜索在代码处理场景中的局限性、抽象语法树（AST）与解析器的基本概念、tree-sitter多语言解析引擎的底层支撑逻辑，以及结构化搜索的技术优势。对于AST相关概念零基础的读者，本部分是构建认知框架的关键；具备相关基础的读者可快速浏览，直接切入实战内容。

基础篇：掌握核心技能

本篇围绕“规模化搜索与规则编写”展开，系统讲解ast-grep的核心语法与基础功能，具体包括元变量的简单模式、用$$$匹配多个节点、用YAML编写规则、用kind按节点类型匹配、应用正则表达式、用逻辑操作符（and、any、not）组合模式，以及用fix执行基础重写。学完这部分，你就能编写实用的模式来搜索和重构代码库了。

中级篇：深化模式编写，实现工具链高效集成

本篇聚焦模式编写技术的进阶提升与工具生态的深度整合，核心内容包括通过context优化歧义模式匹配、用stopBy与field精准控制关系规则作用域、创建可重用的工具规则（utility rules）、约束元变量匹配范围、通过sgconfig.yml进行项目配置、系统化测试规则、基于语言服务器协议（LSP）实现编辑器集成，以及利用游乐场调试规则。学完本篇，读者将从单纯的模式编写者，成长为能构建健壮、可复用且经过验证的规则体系的实践者。

高级篇：深挖ast-grep高阶能力与应用边界

本篇全面解锁ast-grep的进阶特性与底层逻辑，内容涵盖高级模式语法解析、cst/smart/ast/relaxed/signature五种匹配严格度级别应用、递归工具规则设计、元变量转换（replace/substring/convert）、实验性重写器（rewriters）使用、自定义匹配标签增强诊断、编程接口（API）调用、命令行JSON输出与Stdin模式集成、自定义语言注册、嵌入式代码的语言注入处理（如JavaScript中的CSS、模板中的GraphQL），以及工具固有局限说明。本部分助力库作者、工具开发者等高级用户充分释放ast-grep的技术潜力。

本书读者对象

本书面向具备编程基础、希望精通结构化代码搜索、代码扫描（linting）与代码转换技术的开发者。读者需具备至少一种编程语言的实际使用经验，能够读懂代码、理解基本语法，并识别函数调用、变量声明、控制流结构等常见代码构造。

书中示例以JavaScript和TypeScript为主（二者语法通用、Web开发场景应用广泛，适配教学需求），但核心技术与方法论具备跨语言通用性。ast-grep作为多语言工具，本书也同步覆盖C、Go、Python、Rust等语言的示例与案例，直观展示结构化搜索的跨语言适配能力；读者无需精通所有示例语言，依托基础编程认知即可理解核心逻辑。

本书并非编程入门读物，默认读者具备实际编码、调试经验，了解函数、类等基础编程概念，且曾面临代码库搜索/重构的痛点（如用grep/IDE搜索效率低、手动翻找代码耗时、批量重构易出错等）。针对查找函数调用、识别过时API、跨文件代码重构等典型场景，本书将提供精准、自动化的解决方案。

如何使用本书

如果你是结构化代码搜索的新手，建议按“入门篇→基础篇→中级篇→高级篇”的顺序通读全书。本书章节编排遵循 “原理铺垫→语法学习→实战应用” 的认知逻辑：理解AST结构化搜索的核心价值，是掌握模式语法的前提；而模式语法的熟练运用，又是编写复杂规则的基础。循序渐进阅读可构建完整的知识体系，避免因跳过核心概念导致的理解断层。

如果你有明确的需求，可将本书作为速查参考手册，根据具体场景定位对应章节。比如，需匹配多参数/多语句节点序列，可查阅基础篇“$$$多节点匹配”相关内容；需限制元变量匹配范围，可参考中级篇“元变量约束”章节；需为小众语言扩展ast-grep支持：可阅读高级篇“自定义语言注册”章节。

通用阅读建议

• 注重实操验证：ast-grep提供在线游乐场与高性能CLI工具，建议将书中示例复刻至实验环境，通过修改参数、调整模式观察结果变化——主动实操的学习效果远优于被动阅读；

• 聚焦精准理解：本书优先保证技术准确性，不会为简化内容牺牲严谨性。针对命名节点与匿名节点、CST与AST、模式严格度级别等易混淆概念，均会详尽拆解差异；核心目标不仅是教会语法使用，更是帮助读者建立精准的思维模型，能够独立预判工具行为、分析边缘场景。

约定

为保证阅读体验的一致性与准确性，本书做如下约定。

• 代码示例均进行语法高亮处理，并标注所属语言；模式写法与命令行、YAML配置文件中的实际使用格式完全一致，便于读者直接复制使用。

• 语法树结构以缩进文本格式呈现，清晰展示节点类型与层级关系，帮助读者直观理解AST结构。

• 关键术语全书保持统一：元变量（metavariable）特指模式中用于捕获子树的变量（如$VAR）；节点（node）指AST中的基本元素；模式（pattern）指用于结构化匹配的代码片段；规则（rule）指包含模式、严重性、提示消息等元数据的YAML规范。

• 章节交叉引用采用自然文本表述（如“参见基础篇'模式化匹配'章节”），读者可通过目录快速定位对应内容。

致谢

首先，感谢tree-sitter项目的开发者。tree-sitter提供了快速、增量且容错的多语言解析器，为ast-grep的跨语言支持奠定了核心基础，本书的诸多技术讲解也离不开对tree-sitter设计逻辑的参考，理解其解析机制是掌握ast-grep能力边界的关键。

其次，感谢开源社区的所有贡献者与使用者。书中的示例与案例均源自真实生产代码库，而ast-grep的迭代优化也始终围绕开发者的实际痛点展开——脆弱的正则表达式、文本搜索的误报、繁琐的AST操作代码等问题，正是驱动结构化搜索技术发展的核心动力。

最后，感谢每一位读者的信任与支持。希望本书能成为你在代码管理之路上的得力助手，也期待你在使用ast-grep的过程中，持续为开源社区贡献经验与创意。

结语

结构化代码搜索并非新兴技术，而是代码分析与转换任务的“最优抽象层”——它既避开了文本搜索的底层局限性，又降低了编译器API的使用门槛，以语言自身的语法表达代码结构，实现精准、高效的代码操作。

精通ast-grep，本质上是掌握这种“结构化思维”。无论你面对的是小型项目的局部重构，还是大型代码库的全局治理，亦或是自定义工具链的开发，这种思维能力都将持续为你的职业生涯创造价值。

本书旨在为你搭建通往“结构化代码处理精通之路”的桥梁，从原理到实践，从基础到进阶，全方位助力你解锁ast-grep的全部潜力。愿你在阅读与实践中收获成长，让代码管理变得更精准、更高效。

入门篇 
夯实概念基础

第1章 ast-grep 简介

1.1 什么是 ast-grep？

ast-grep 是一款结构化代码搜索、扫描（linting）和重写工具，它操作的是抽象语法树（AST），而不是原始文本。它像 grep 一样简洁快速，又像编译器一样精准地理解代码结构。文本搜索只能把代码当作字符串处理，正则表达式无法应对嵌套结构，而 ast-grep 能像编译器那样真正理解代码——把它看作由语法元素组成的树形结构。

ast-grep 和基于文本的工具有本质区别：它在代码的结构化树状表示上工作。这意味着搜索时不受格式变化影响，能理解嵌套结构，还能区分语法相同但结构不同的代码元素。搜索一个函数调用时，不管参数格式、空格或换行怎么变，都能匹配到——因为它匹配的是结构，不是文本模式。

考虑以下调用：

ast-grep --pattern 'var code = $PAT' --rewrite 'let code = $PAT' --lang js

这条命令将 JavaScript 文件中所有的 var 声明转换为 let 声明。元变量 $PAT 可以捕获任意表达式，重写时保留原有赋值内容，不管表达式有多复杂。模式匹配的是语法结构，不是文本字符串；格式和空格怎么变都不影响匹配。

1.2 基于文本的代码搜索之局限

grep 这类传统文本工具只是在字符序列上查找。这种方法虽然快速通用，但遇到代码的结构性问题就束手无策了。正则表达式在文本处理方面确实很强大，但无法可靠地解析嵌套或递归结构——而这恰恰是几乎所有编程语言的基本特征。

当文本搜索失效时

假设要搜索函数调用 console.log(message)。简单的 grep 或正则方法马上就会遇到问题：

格式与结构变体：函数调用有多种写法，这些变体常常让文本匹配无从下手。空格、换行、尾随逗号和参数格式都会改变文本表现，但代码结构其实是一样的：

console.log(message)
console.log(
  message
)
console.log( message )
console.log ( message )
console.log(
  message,
)
console.log(
  message1,
  message2,
  message3
)

文本模式 console.log(message) 只能匹配第一种变体。正则表达式可以用 \s* 和可选标记来兼容空格变化，但模式会变得极其复杂：console\s*\.\s*log\s*\(\s*message\s*,?\s*\)。即便如此，遇到换行分隔 token 或额外参数时，这个模式还是会失效。试图穷举所有格式组合，只会写出脆弱且难以维护的表达式。

嵌套结构：代码天生具有递归性，这从根本上超出了正则表达式的能力。函数参数本身可能包含函数调用，产生任意层级的嵌套：

console.log(format(getMessage(user.name, user.id)))

用正则匹配这种结构，需要能处理嵌套括号的模式——这属于上下文无关语法（context-free language）的范畴，而正则表达式基于正则语言（regular languages），无法正确解析。试试从 console.log 中提取参数：

console\.log\(([^()]*(?:\([^()]*\))?[^()]*)\)

这个模式用非捕获组和可选括号来处理一层嵌套。但遇到 format(getMessage(user.name, user.id)) 这样的两层嵌套就不行了。从理论上说，纯正则表达式无法处理任意深度的嵌套——正则语言本身就不具备这个能力。实际的正则引擎虽然提供了扩展（递归模式、反向引用），但通常以牺牲性能为代价，而且表达式会变得难以理解。

理解难度：除了理论限制，正则表达式还很难维护。能处理真实代码复杂度的模式，往往是一堆晦涩的字符序列，需要仔细分析才能看懂。比如从任意函数调用中提取函数名和第一个参数：

([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\.\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(\s*([^,)]+)

这个模式用三个捕获组匹配 console.log(message)：对象名、方法名和第一个参数。要理解它捕获了什么，得先解析字符类定义、量词和转义的元字符。如果还要处理更多情况——可选链、计算属性、模板字符串——复杂度会成倍增加。六个月后，作者自己恐怕都看不懂这个模式了。

字符串与注释中的误匹配：文本搜索分不清代码和非代码：

// 不要在生产环境中调用 console.log()
const warning = "记住：console.log(data) 运行很慢";
console.log(data);

用 grep 搜索 console.log 会匹配所有三行，但只有第三行才是真正的函数调用。

语法语境：考虑查找变量赋值。文本 x = 5 可能出现在很多地方：

let x = 5;           // 带初始化的变量声明
x = 5;               // 赋值表达式
class A { x = 5 }    // 字段初始化
const msg = "x = 5"; // 字符串字面量

正则表达式操作的是字符序列，分不清这些语法语境。它们没有作用域、语法和程序结构的概念。

为什么基于 AST 的搜索能成功

抽象语法树把代码表示为层级结构。在这个结构里，格式无关紧要，代码结构一目了然。树中每个节点都代表一个语法构造——函数调用、标识符、二元运算——并和其他节点有明确的关系。

代码解析为 AST 后：

• 空格和格式消失了，它们不是树的一部分

• 注释通常被忽略或单独存储

• 语法元素按类型分类：function_call、identifier、assignment_expression

• 树状结构反映了嵌套和作用域关系

对于前面的 console.log(message) 示例，AST 表示抽象掉了格式：

call_expression
├── member_expression
│   ├── object: identifier ("console")
│   └── property: identifier ("log")
└── arguments
    └── identifier ("message")

不管空格、换行或注释怎么放，这个树结构都是一样的。匹配这个结构的模式会自动匹配所有格式变体。

1.3 ast-grep 如何解决问题

ast-grep 提供了一套在抽象语法树上进行模式匹配的系统，同时保留了命令行文本搜索的简洁性。你不用编写繁琐的 AST 遍历代码或构建复杂的正则表达式，直接用目标语言本身来写模式就行。

基于模式的匹配

核心机制：用代码搜索代码。模式用目标语言的语法编写，ast-grep 在代码库中匹配该语法结构。元变量（以 $ 开头的标识符）作为占位符，可以匹配并捕获子树。

模式 console.log($MSG) 匹配任何带一个参数的 console.log 调用，并把参数捕获到元变量 $MSG 中。它能匹配：

• console.log(message) —— 捕获 message

• console.log("Hello") —— 捕获 "Hello"

• console.log(x + y) —— 捕获 x + y

• console.log(fn()) —— 捕获 fn()

模式忽略格式差异。以下写法都能匹配：

console.log(message)
console.log( message )
console.log(
  message
)

代码中的注释由解析器透明处理；AST 表示会忽略它们，所以不管注释怎么放，模式都能匹配。

通过 Tree-Sitter 实现多语言支持

ast-grep 基于 tree-sitter，这是一个解析器生成库，为众多语言提供快速、增量的解析器。Tree-sitter 根据语法规范生成解析器，产生具体语法树（CST）——一种包含所有语法元素的完整树状表示。

ast-grep 用 tree-sitter 解析代码库和搜索模式，从而实现多语言支持：同样的模式匹配原则适用于多种语言。目前支持的语言：

每种语言都需要一个 tree-sitter 语法，定义该语言的解析规则和节点类型。ast-grep 的模式匹配作用于生成的 AST，与源语言无关。

1.4 核心能力

ast-grep 提供三种主要操作模式，都建立在基于 AST 的模式匹配之上：

搜索 (Search)：命令行工具在代码库中执行结构化搜索，几秒钟就能扫描数千个文件。模式匹配结构化代码，避免了注释、字符串和格式变化导致的误报。

扫描 (Lint)：规则系统支持用 YAML 定义自定义扫描规则。规则通过逻辑运算符组合模式，可以指定任意复杂的匹配条件。每个规则包含模式、严重级别和消息，可集成到开发工作流中作为代码扫描器或语言服务器。

重写 (Rewrite)：模式可以配合重写模板，实现自动化代码转换。匹配时捕获的元变量会代入重写模板，从而实现保留原有表达式的重构。编程 API 为复杂转换或代码生成提供了细粒度控制。

1.5 为什么结构化搜索至关重要

结构化搜索在代码处理的正确抽象层级上工作。文本层级太低，会把语法结构和格式混为一谈；AST 操作 API 又太底层，暴露了实现细节，需要繁琐的遍历逻辑。

基于模式匹配的结构化搜索兼具两方面优势：结构精准度——模式匹配的是代码结构，不是字符序列；同时保持简洁——模式用目标语言编写，不需要 API 调用或复杂的正则表达式。

这种方法的好处：

精准匹配：模式匹配代码构造，同时忽略格式、注释和语法变体。搜索函数调用只会匹配真正的调用，不会匹配字符串或注释中的文本。

自动处理变体：格式差异、换行、尾随逗号和空格变化都不影响模式匹配。AST 表示会规范化这些变体。

元变量捕获：捕获的子树可以在重写模板中重用，从而实现保留复杂表达式的重构。模式可以捕获函数参数并重新排列，或者提取变量初始化器并移动位置。

结构感知：模式能区分语法语境。赋值表达式的模式不会匹配等值比较或结构不同的变量声明，即使文本看起来很像。

ast-grep 把 grep 的易用性和编译器工具的精准度结合起来，让结构化搜索在日常开发中切实可用。

1.6 与 AST 操作 API 的比较

通过编译器 API 直接操作 AST 虽然精准，但认知负担很重。比如用 Babel 的 AST API 匹配 JavaScript 中的 console.log：

path.parentPath.isMemberExpression() &&
path.parentPath.get('object').isIdentifier({ name: 'console' }) &&
path.parentPath.get('property').isIdentifier({ name: 'log' })

这段代码要求你理解 Babel 的节点遍历 API、特定的类型检查方法、属性访问方式，以及成员表达式的结构。而等效的 ast-grep 模式只需：

ast-grep -p "console.log"

模式就是代码本身。没有 API 方法，没有遍历逻辑，没有节点类型判断。ast-grep 把模式解析为 AST，然后和目标代码进行结构匹配。

这种区别不只是简单性的问题。AST 操作 API 是语言特定的：Babel 处理 JavaScript，Python 需要 ast 模块知识，Go 需要 go/ast。每种 API 都有独特的约定、方法和节点类型。ast-grep 的模式语法在不同语言间保持一致——模式始终用目标语言自身的语法编写。

正如 HackerOne 联合创始人 Jobert Abma 所说：

ast-grep 通过消除学习 AST 操作 API 的需求解决了这个问题。模式语言就是编程语言本身。

1.7 设计特性

以下设计决策让 ast-grep 脱颖而出（相较于 Semgrep、comby、shisho、gogocode 和 gritQL 等工具）：

性能：用 Rust 实现并支持并行处理，ast-grep 几秒钟就能处理数万个文件。Tree-sitter 解析器速度极快且支持增量解析，保证了交互式使用的响应速度。

渐进式采用：工具支持从简单的命令行调用，到复杂的规则系统，再到编程 API 使用的渐进过程。你可以从一个简单的模式字符串开始，进阶到组合多个模式的 YAML 规则，最终用 API 进行复杂转换或自定义工具开发。

集成化工具链：命令行工具内置了规则作者所需的测试框架、用于编辑器集成的语言服务器以及交互式修改功能。安装后即可使用，无需额外配置。

这种简洁性、性能与集成化工具链的结合，让 ast-grep 既能胜任日常开发任务，又能支撑复杂的代码分析与转换工作流。