# 结构化搜索与替换对话框

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

> **TL;DR**
> `编辑 | 查找 | 结构化搜索`
>
>
>
> `编辑 | 查找 | 结构性替换`

请使用这些对话框查找并替换与建议的 [search template](search-templates.html) 结构匹配的代码片段。

> **Tip:**
> 关于可能的用途的更多信息，请参阅该部分 [结构化搜索和替换](structural-search-and-replace.html)。

|  条目  |  描述  |  可用  |
| --- | --- | --- |
|  搜索模板  |  请使用此文本区域指定 IntelliJ IDEA 执行搜索过程所基于的 [模板](search-templates.html)。 可以在该字段中输入模板代码，或点击 ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 并选择   现有模板   选项以查看现有模板列表。  |  两者  |
|  区分大小写  |  如果您希望 IntelliJ IDEA 匹配您正在搜索的代码的大小写，请勾选此复选框。  |  两者  |
|  文件类型  |  请使用此选项选择搜索的文件类型。 在这种情况下，IntelliJ IDEA 仅在指定的文件类型中搜索。  |  两者  |
|  ![筛选图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.filter.svg)  |  点击此图标以为整个搜索模板添加 [修饰符](search-templates.html#ssr_filters)。 请使用 !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加一个新的修饰符或使用 ![删除图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 删除现有的修饰符。  |  两者  |
|  !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |     点击此图标以选择以下选项之一：        * 保存模板 ：使用此选项保存您在搜索模板区域中指定的模板。 IntelliJ IDEA 将保存的模板添加到 用户定义 节点中的 现有模板 对话框中。    * 导出模板到剪贴板 ：使用此选项 [导出模板](structural-search-and-replace.html#share_template)并共享。    * 导入模板到剪贴板 ：使用此选项来 [导入共享模板](structural-search-and-replace.html#share_template)。    * 现有模板 ：使用此选项查看现有模板列表。 在 现有模板 对话框中，选择一个预定义或自定义的模板。 所选模板显示在 预览 字段中。 当您点击 OK 时，IntelliJ IDEA会将模板的源代码插入到 搜索模板 字段或 替换模板 字段中。    * 切换到搜索 / 切换到替换 ：使用此选项可快速切换到 结构搜索 或 结构替换 对话框。    |  两者  |
|  替换模板  |  请使用此文本区指定要替换的 [模板](search-templates.html)。 可以在该字段中输入模板代码，或点击 ![设置按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 并选择   现有模板   选项以查看现有模板列表。  |  结构替换  |
|  ![搜索](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.search.svg)  |  点击此图标以查看您之前的搜索列表。  |  两者  |
|  缩短完全限定名  |  如果模板文本包含完全限定的类名，此选项才有意义。 如果选中复选框，IntelliJ IDEA 会自动缩减模板中的这些名称。 否则，将使用完全限定类名。  |  结构替换  |
|  重新格式化  |  如果您希望 IntelliJ IDEA 根据您的代码样式设置自动重新格式化展开的代码片段，请选中此选项（详细信息请参阅 [代码样式](settings-code-style.html) 对话框）。 如果未选中该选项，IntelliJ IDEA将仅根据其展开的代码位置对整个模板进行缩进，格式保持不变。  |  结构替换  |
|  使用静态导入  |  如果您希望 IntelliJ IDEA 缩短替换代码中对静态元素的任何引用，请选中此选项。 IntelliJ IDEA 将为这些元素插入一个静态导入。 然后通过它们的简称引用这些元素。 如果替换代码中没有对静态元素的引用，则该选项将被忽略。  |  结构替换  |
|  范围  |  使用此区域指定 IntelliJ IDEA 应在何处搜索并替换您的代码。    您可以从以下选项中进行选择：        * 项目 ：当您选择此选项时，IntelliJ IDEA 会在整个项目中搜索并替换指定的模板。    * 模块 ：当您选择此选项时，IntelliJ IDEA 会在选中的模块中搜索并替换指定的模板。    * 目录 ：当您选择此选项时，IntelliJ IDEA 会在所选目录中搜索并替换指定的模板。    * 范围 ：当您选择此选项时，IntelliJ IDEA 会在您选择的特定范围内搜索和替换指定的模板。 可以从可用列表中选择预定义作用域，或创建 [自定义作用域](settings-scopes.html)，方法是点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)。    |  两者  |
|  搜索目标  |  使用此选项来指定您的搜索过程的目标，它可以是您指定的模板的完全匹配（   完全匹配  ）或只是其中的一部分。 搜索目标的选项取决于您所选择的文件类型。  |  两者  |
|  在新选项卡中打开  |  如果选中此复选框，新搜索的结果将显示在“查找结果”工具窗口的新选项卡中。 否则，搜索结果会更新现有标签页。  |  两者  |

## See also

### 概念

[搜索模板、修饰符和脚本约束](search-templates.html)

### 过程

[结构化搜索和替换](structural-search-and-replace.html)