技能介绍

为什么要放弃正则和手工改动

做大规模迁移——API 改造、策略清理、替换旧模块——时，常规工具往往不够用。正则只能按文本匹配，一旦代码格式稍有变化：换行位置不同、引号风格不同、变量命名不同，匹配就可能漂移。手工改动则难以覆盖大规模代码库，产出的 diff 也很难逐条审查。迁移真正需要的是基于语法结构的重写：代码解析后的树形结构匹配上了才算命中，每次改动都输出可审查的 diff。

GritQL 的工作方式

这个技能的核心是使用 GritQL 结构化模式来定义「匹配什么」和「如何重写」：

模式写在反引号里，直接描述目标结构，例如在仓库中找出所有 console.log 调用。
匹配发生在解析树层面而非文本层面，对格式差异有天然鲁棒性。
多个模式可以组合成复杂查询，包括大型重构任务。
重写结果以 diff 形式产出，进入人工审查循环逐条确认。

前提是准备好 Grit CLI、一个本地仓库，以及一套检查结构化模式产出 diff 的审查流程。

语言覆盖与上手门槛

学会 GritQL 之后，同一套模式语言可以用于重写多种语言：JavaScript/TypeScript、Python、JSON、Java、Terraform、Solidity、CSS、Markdown、YAML、Rust、Go 等。官方文档、交互式教程和 grit --help 都是合理的入门入口。

需要注意的一点：读写 codemod 时，需要把 AST 节点名在脑中翻译回源码的真实样貌。当模式行为不符合预期时，排查对象是抽象语法树的结构，而不是原始文本。