ast-grep的files与ignores配置过滤失效问题求助

我在用ast-grep检测Java文件中的模式，但files和ignores过滤配置未按预期工作。项目同时包含src和tst目录，希望仅匹配src目录的源文件，忽略tst目录的测试文件，相关配置及执行代码如下：

配置文件 #

id: detect_initialise
language: java
rule:
  kind: expression_statement
  regex: Service.initialize
files:
   - "**/src/**/*.java"
ignores:
  - "**/tst/**/*.java"

执行代码 #

command = [
    f"{AST_GREP_CMD}",
    "scan",
    "-r",
    f"{str(path_to_ast-grep_recipe)}",
    f"{project_repo_path}",
]
ast_grep_dryrun_result = self.executor.run(command)

问题 #

尽管已设置files仅包含src目录，并显式添加ignores规则排除tst目录，但模式仍匹配了两个目录下的Java类，与预期不符。想请教：

1. 我的files和ignores字段语法是否正确？
2. ast-grep的文件过滤是否存在已知问题或限制？
3. 我是否忽略了ast-grep处理files/ignores配置的某些细节？

排查与解答 #

1. 语法正确性
   你的files和ignores语法本身符合ast-grep规则，**用来匹配任意层级目录，路径写法逻辑上没问题。ast-grep的处理逻辑是先通过files筛选出候选文件，再用ignores从候选集中排除，你的配置逻辑是自洽的。

2. 已知问题/限制

   • 版本bug：旧版本ast-grep（如v0.10.x及更早）存在文件匹配规则的解析问题，比如嵌套目录的**匹配不准确、files与ignores组合逻辑异常，建议升级到最新稳定版本尝试。
   • 命令行参数冲突：如果执行命令中额外传递了--include/--exclude这类参数，会覆盖配置文件中的规则，检查AST_GREP_CMD或命令拼接时有没有添加这类参数。

3. 容易忽略的细节

   • 路径基准问题：文件匹配是基于你传入的project_repo_path作为根目录的，如果project_repo_path不是项目根目录，会导致路径匹配规则失效。比如你传入的是./src，那**/src/**/*.java就找不到对应文件了。
   • 配置加载验证：用ast-grep scan --show-config -r <你的配置文件路径>命令查看实际生效的配置，确认files和ignores是否被正确读取。
   • 特殊目录影响：如果tst是符号链接，ast-grep可能无法正确识别忽略规则，导致匹配到链接指向的文件；另外隐藏文件、系统目录也可能干扰匹配，检查目录结构是否存在这类情况。
   • 规则验证：先单独扫描src目录验证规则：ast-grep scan -r <配置文件> ./src，如果只返回src的结果，说明规则本身没问题；再扫描tst目录，如果返回结果，说明过滤配置确实未生效，否则可能是你误判了匹配结果的来源。

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