IDEA Structural Search 使用详解<\/h1>

概述<\/h2>

IDEA Structural Search 是 IntelliJ IDEA 提供的一个强大的代码搜索功能，它基于代码的结构（AST抽象语法树）进行搜索，比传统的文本搜索更精确和灵活。特别适用于以下场景：<\/p>

需要查找同时满足多个条件的类或方法（如同时实现多个接口）<\/li>
需要基于代码结构而非简单文本进行搜索<\/li>

需要快速筛选大量候选类时<\/li> <\/ol>

功能优势<\/h2>

轻量级<\/strong>：相比 CodeQL、Tabby 等工具学习成本低，无需额外配置<\/li>
精确匹配<\/strong>：基于代码结构而非文本，避免误匹配<\/li>
实时反馈<\/strong>：编辑模板时即时显示匹配结果<\/li>

集成环境<\/strong>：直接在 IDE 中使用，无需切换工具<\/li> <\/ol>
功能入口<\/h2>
在 IntelliJ IDEA 中：<\/p>

主菜单选择 Edit<\/code> → Find<\/code> → Search Structurally...<\/code><\/li>
或使用快捷键（Windows\/Linux: Ctrl+Shift+S，Mac: Command+Shift+S）<\/li> <\/ol> 核心概念<\/h2> 模板框架 (Template)<\/h3> 搜索的基本结构，使用 Java 代码片段表示要匹配的模式。例如：<\/p> class<\/span> $Class$<\/span> implements<\/span> $Interface1$,<\/span> $Interface2$ {}<\/span> <\/span><\/span><\/code><\/pre>模板变量 (Template Variables)<\/h3> 用 $变量名$<\/code> 表示的可变部分，如 $Class$<\/code>、$Interface1$<\/code> 等。<\/p> 过滤器 (Filters)<\/h3> 对变量添加的约束条件，是 Structural Search 的核心功能。<\/p> 过滤器类型详解<\/h2> 1. Text 过滤器<\/h3> 功能<\/strong>：基于文本内容匹配<\/li> 用途<\/strong>：匹配特定类名（支持正则表达式）<\/li> 匹配特定字符串内容<\/li> <\/ul> <\/li> <\/ul> 示例：<\/p> $Interface1$:text = java\.util\.Comparator <\/code><\/pre> 2. Within type hierarchy<\/h3> 功能<\/strong>：包含继承层次中的匹配<\/li> 用途<\/strong>：查找直接或间接实现接口\/继承类的元素<\/li> 建议<\/strong>：通常应开启以获得更全面的结果<\/li> <\/ul> 3. Count 过滤器<\/h3> 功能<\/strong>：控制变量出现的次数<\/li> 用途<\/strong>：限制方法参数数量、类实现接口数量等<\/li> <\/ul> 4. Reference 过滤器<\/h3> 功能<\/strong>：基于引用的高级匹配<\/li> 用途<\/strong>：如查找被特定注解标记的方法<\/li> <\/ul> 示例：查找被注解的方法调用：<\/p> $MethodCall$();<\/span> <\/span><\/span><\/code><\/pre>然后为 $MethodCall$<\/code> 添加 Annotated methods<\/code> 过滤条件<\/p> 5. Invert modifier<\/h3> 功能<\/strong>：反转选择条件<\/li> 用途<\/strong>：查找不符合某条件的元素<\/li> <\/ul> 6. Script 过滤器<\/h3> 功能<\/strong>：使用 Groovy 脚本进行复杂条件判断<\/li> 用途<\/strong>：实现无法通过简单条件表达的逻辑<\/li> <\/ul> 示例：查找非接口、非枚举、非记录类的类：<\/p> !<\/span>isInterface()<\/span> &&<\/span> !<\/span>isEnum()<\/span> &&<\/span> !<\/span>isRecord()<\/span> <\/span><\/span><\/code><\/pre>7. Type 过滤器<\/h3> 功能<\/strong>：指定变量类型<\/li> 用途<\/strong>：精确匹配特定类型的元素<\/li> <\/ul> 实用功能<\/h2> 1. 目标选择 (Target)<\/h3> 可指定搜索的目标类型：<\/p> 类<\/li> 方法<\/li> 字段<\/li> 语句等<\/li> <\/ul> 2. 扫描范围 (Scan Scope)<\/h3> 可设置搜索范围：<\/p> 整个项目 (In Project)<\/li> 特定模块 (Module)<\/li> 指定目录 (Directory)<\/li> 自定义范围 (Scope)<\/li> <\/ul> 3. 实时匹配<\/h3> 编辑模板时，IDE 会实时在当前文件中显示匹配结果，便于调试模板<\/p> 4. 模板管理<\/h3> 保存模板<\/strong>：可将常用模板保存供后续使用<\/li> 分类<\/strong>： Draft Template：草稿<\/li> Recent：最近使用的模板<\/li> Saved Template：已保存的模板<\/li> <\/ul> <\/li> <\/ul> 实际案例<\/h2> 案例1：查找同时实现两个接口的类<\/h3> 需求<\/strong>：查找同时实现 java.util.Comparator<\/code> 和 java.io.Serializable<\/code> 的类<\/p> 模板<\/strong>：<\/p> class<\/span> $Class$<\/span> implements<\/span> $Interface1$,<\/span> $Interface2$ {}<\/span> <\/span><\/span><\/code><\/pre>过滤器设置<\/strong>：<\/p> $Interface1$<\/code>: Text: java\.util\.Comparator<\/code><\/li> Within type hierarchy: 开启<\/li> <\/ul> <\/li> $Interface2$<\/code>: Text: java\.io\.Serializable<\/code><\/li> Within type hierarchy: 开启<\/li> <\/ul> <\/li> <\/ul> 案例2：查找被特定注解标记的方法调用<\/h3> 模板<\/strong>：<\/p> $MethodCall$();<\/span> <\/span><\/span><\/code><\/pre>过滤器设置<\/strong>：<\/p> $MethodCall$<\/code>: Reference → Annotated methods<\/li> <\/ul> <\/li> <\/ul> 使用技巧<\/h2> 依赖搜索<\/strong>：要搜索依赖中的代码，需确保已下载依赖的源码和文档<\/li> 变量命名<\/strong>：变量名无特殊要求，但建议使用有意义的名称<\/li> 组合过滤<\/strong>：可对同一变量应用多个过滤条件<\/li> 正则表达式<\/strong>：Text 过滤器支持正则表达式，提高匹配灵活性<\/li> <\/ol> 适用场景<\/h2> 接口实现的交叉查询<\/li> 需要从大量候选类中筛选特定条件的类<\/li> 查找具有固定模式的代码结构<\/li> 需要精确匹配代码语义而非简单文本<\/li> <\/ol> 注意事项<\/h2> 模板语法必须符合 Java 语法规则<\/li> 变量类型由其所在位置决定<\/li> 复杂的搜索可能需要组合多个过滤条件<\/li> 对于非常复杂的查询，可能需要使用 Script 过滤器<\/li> <\/ol> 高级功能<\/h2> Structural Search 还支持代码替换功能，可通过 Edit<\/code> → Find<\/code> → Replace Structurally...<\/code> 访问，用法与搜索类似但增加了替换模板。<\/p> 参考资源<\/h2> 官方文档: https:\/\/www.jetbrains.com\/help\/idea\/structural-search-and-replace.html<\/a><\/li> 官方示例模板: 在 Structural Search 对话框的 "Others" 菜单中查看<\/li> <\/ul>

IDEA Structural Search 使用详解<\/h1>

核心概念<\/h2>

模板变量 (Template Variables)<\/h3>
用 `$变量名$<\/code> 表示的可变部分，如 $Class$<\/code>、$Interface1$<\/code> 等。<\/p>`

过滤器类型详解<\/h2>

实用功能<\/h2>

3. 实时匹配<\/h3>
编辑模板时，IDE 会实时在当前文件中显示匹配结果，便于调试模板<\/p>

实际案例<\/h2>

高级功能<\/h2>
Structural Search 还支持代码替换功能，可通过 `Edit<\/code> → Find<\/code> → Replace Structurally...<\/code> 访问，用法与搜索类似但增加了替换模板。<\/p>`

`参考资源<\/h2> 官方文档: https:\/\/www.jetbrains.com\/help\/idea\/structural-search-and-replace.html<\/a><\/li> 官方示例模板: 在 Structural Search 对话框的 "Others" 菜单中查看<\/li> <\/ul>`