SuperAPI AI 工具集

ast-grep

编程与开发

查看项目

更新于 10-16 09:54

技能介绍

用途:将自然语言查询转写为 ast-grep 规则,用 AST 模式按代码结构而非文本匹配,在大型代码库中做精确搜索。适用情形包括查找特定语言构造、需要理解代码结构而非文本的检索、复杂查询等。

通用流程:先厘清用户要找的结构、语言与边界情况;写一个示例代码片段存为临时文件;把模式转译为规则,简单结构用 pattern,复杂结构用 kind 配合 has/inside,用 all、any、not 拆分子规则;用 CLI 验证匹配;再搜索实际代码库。

主要命令:用 ast-grep run 做模式搜索,例如 ast-grep run --pattern 'console.log($ARG)' --lang javascript /path/to/project;用 ast-grep scan 做规则搜索,如 ast-grep scan --rule my_rule.yml /path/to/project,或 ast-grep scan --inline-rules "..."。可用 --stdin 测试片段,--json 输出结构化结果,--debug-query=cst 查看语法树结构。

要点:关系规则(inside、has)建议加 stopBy: end;内联规则中元变量需转义,如 $VAR 或使用单引号。

限制:资料未说明支持的编辑器集成、安装方式、收费与性能数据,均暂未提供。