# 结构化搜索和替换

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

传统的搜索过程不会考虑源代码的语法和语义。 即使您使用正则表达式，IntelliJ IDEA 仍然将您的代码视为常规文本。  结构化搜索和替换 （  SSR ）操作允许您根据代码结构在代码中搜索特定的代码模式或语法结构。

IntelliJ IDEA 根据您创建的 [search templates](search-templates.html)和您应用的 [conditions](search-templates.html#ssr_filters)查找和替换源代码片段。

> **Note:**
> 当前，IntelliJ IDEA 支持 Java、Kotlin、Scala 和 Groovy 的结构搜索和替换。

Procedure: 结构性地搜索目标

1. 在主菜单中，转到  `编辑 | 查找 | 结构化搜索`  以打开   结构搜索   对话框。

要快速切换到   结构替换   对话框，请点击 ![“切换到替换”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.refresh.svg)。

2. 在   结构搜索   对话框中，执行以下操作之一：

* 从头创建模板：在模板列表中选择 草稿模板 ，并在编辑器区域中输入代码模板（例如，使用 `$variable$` 表示您的代码）。 要保存自定义模板以供以后使用，请在对话框工具栏上点击 保存模板 图标（ ![保存模板按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.save.svg)）。 您也可以选择将该模板保存为检查。 ![结构搜索对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/structural_search_dialog.png) IntelliJ IDEA 会将创建的模板添加到模板列表中的 最近 节点。

* 使用现有模板作为原型：从可用的现有模板列表中选择所需的模板。 例如，您的代码中有以下字段： ```JAVA public class MainActivity { public static final String this_is_wrong = "Hello"; public static final String THIS_IS_CORRECT = "world"; } ``` 让我们在类中找到某个字段。 在现有模板列表中，点击 Java 并打开 基于类 节点（因为我们需要类中的字段），因此 类的字段 模板将是我们的目标。 ![现有模板列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/existing_templates.png) 点击 查找 ，在整个项目中搜索这些结构。 IntelliJ IDEA 会在编辑器中立即高亮显示找到的代码出现位置。

3. 在   结构搜索   对话框中会显示所选模板及其过滤器的值。 您可以编辑现有过滤器，或添加新的 [条件](search-templates.html#ssr_filters)，例如正则表达式或 [脚本约束](search-templates.html#script_constraints)。 将插入符号置于某个代码变量上，并使用过滤器区域管理其过滤器。

![编辑筛选器](https://resources.jetbrains.com.cn/help/img/idea/2026.3/Edit_filters.png)

4. 在此示例中，为   文本   变量添加一个  `$Field$`  修饰符。

5. 对于   文本   修饰符，输入以下正则表达式：

```REGEX
\b[A-Z].*?\b

```

![在过滤器对话框中添加正则表达式](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add_filter_text_regex_ssr.png)

在这种情况下，当您在   结构搜索   对话框中选中   区分大小写   复选框时， IntelliJ IDEA 仅搜索首字符为大写的字段。

还提供其他选项，具体取决于所选语言。

例如，请查看以下选项：

* 语言 ：使用该列表选择要在搜索中包含的文件类型。 在此情况下，它为 Java 。

* 目标 ：使用该列表选择要搜索的项。 在此情况下，它为 `Field` 。 ![搜索目标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ssr_search_target.png)

* 递归 ：选中后， IntelliJ IDEA 将执行递归搜索，所有嵌套项都会包含在结果中。 例如，在启用 递归 的情况下搜索方法调用时， IntelliJ IDEA 会在 `foo(foo(foo()))` 中找到嵌套调用。 禁用 递归 时，仅会找到外层调用。

* 注入的代码 ：选中后，诸如 HTML 中的 JavaScript 或 Java 中的 SQL 等注入的代码将包含在搜索中。

* 区分大小写 ：选中后，搜索结果将与搜索目标的大小写匹配。

6. 指定搜索范围：项目、模块、目录或自定义范围。

7. 点击   查找  。

IntelliJ IDEA 会在   查找   工具窗口中显示结果。

![查找工具窗口结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ssr_find_tool_window_results.png)

您可以将新的搜索模板作为自定义模板添加到 [结构化搜索检查](creating-custom-inspections.html)。 为此，请在   查找   工具窗口中点击   从模板创建检查  。 随后即可重复使用它来检查您的代码。

> **Note:**
> 在某些情况下，检查可以替代结构化搜索与替换。 例如，通过结构化搜索将类替换为接口不会更新用法，因此您需要多次运行搜索与替换。 在这种情况下，您可以使用  抽象类可以为接口  检查，该检查还会更新该抽象类的用法。

Procedure: 替换一个目标结构

1. 在主菜单中，前往  `编辑 | 查找 | 结构性替换` 。

2. 在   按结构替换   对话框中，向搜索和替换模板区域添加新模板或 [现有模板](#existing_templates)。 您可以像 [search](#ws_save_template) 模板一样保存替换模板。

3. 如果您需要为替换模板中的变量添加过滤器，请将文本光标放在相关变量处，并使用过滤器区域来管理过滤器。

4. 在过滤器区域中，根据您选择的 [过滤器](search-templates.html#ssr_filters)，指定条件。

例如，我们拿一个变量  `$Field$` ，然后我们 [搜寻](#field_condition)并添加一个条件，以将找到的模板替换为小写字符。

将变量命名为  `$Field2$` ，并添加以下筛选器  脚本 ，该筛选器基本上是一个 Groovy 脚本：  `Field.name.toLowerCase()` 。

![替换模板](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ssr_replace_pattern.png)

5. 要缩小替换结果，请选择以下选项：

* 缩短完全限定名称 - 将完全限定类名替换为简短名称和导入。

* 重新格式化 - 会自动格式化替换的代码。

* 使用 static import - 在可能的情况下使用静态导入进行替换。 例如，如果选择此选项，对静态方法的调用 `Math.abs(i)` 将变成 `abs(i)` 。

指定必要选项后，点击   查找  。 IntelliJ IDEA 在   查找   工具窗口中显示结果。

6. 在   查找  工具窗口中，您可以进一步处理结果，逐一替换找到的项目，或一次性替换所有项目，或预览您潜在的更改。

您还可以将替换模板添加到 [结构化查找检查](creating-custom-inspections.html)中，并将其用作代码的快速修复。

![带有替换预览的 Find 工具窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ssr_replace_preview.png)

由于我们的替换，所有大写字符都被转换为小写字符。

![替换结果](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ssr_replace_result.png)

Procedure: 共享搜索模板

您可以通过导出或导入搜索模板与同事共享。

1. 在   结构搜索   对话框  `编辑 | 查找 | 结构化搜索`  中， [创建一个新的搜索模板或使用现有的模板](#to_search_structurally)。

2. 要导出模板，请点击 ![“导出模板到剪贴板”图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.export.svg)。 IntelliJ IDEA 将模板的 XML 表示添加到剪贴板（按 `Ctrl+Shift+V` (Windows), `⌘ ⇧ V` (macOS), `⌘ ⇧ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ V` (macOS System Shortcuts), `Ctrl+Shift+V` (XWin), `Ctrl+Shift+V` (GNOME), `Ctrl+Shift+V` (KDE), `Alt+Y` (Emacs), `Ctrl+K, Ctrl+V` (Sublime Text), `⌘ K, ⌘ V` (Sublime Text (macOS)), `Ctrl+Shift+V` (Visual Studio), `⌘ ⇧ V` (Visual Studio (macOS)), `Ctrl+Shift+V` (NetBeans), `Ctrl+Shift+V` (Eclipse), `⌘ ⇧ V` (Eclipse (macOS)) 以查看剪贴板内容）。 您可以在聊天、电子邮件或论坛中与其他开发者共享此表示形式。

要导入模板，请从任何地方（电子邮件、聊天或论坛）复制（ `Ctrl+C` (Windows), `⌘ C` (macOS), `⌘ C` (IntelliJ IDEA Classic (macOS)), `⌘ C` (macOS System Shortcuts), `Ctrl+C` (XWin), `Ctrl+C` (GNOME), `Ctrl+C` (KDE), `Ctrl+Insert` (Emacs), `Ctrl+C` (Sublime Text), `⌘ C` (Sublime Text (macOS)), `Ctrl+C` (Visual Studio), `⌘ C` (Visual Studio (macOS)), `Ctrl+C` (NetBeans), `Ctrl+C` (Eclipse), `⌘ C` (Eclipse (macOS))）共享的 XML 代码，并在   结构搜索  对话框中点击 ![从剪贴板导入模板图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.import.svg)。 IntelliJ IDEA 接受 XML 代码表示并将其转换为模板，包括变量和作用域（如果存在）。

