llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

结构化搜索和替换

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

IntelliJ IDEA 根据您创建的 search templates和您应用的 conditions查找和替换源代码片段。

结构性地搜索目标

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

    要快速切换到 结构替换 对话框,请点击 “切换到替换”图标。

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

    • 从头创建模板:在模板列表中选择 草稿模板 ,并在编辑器区域中输入代码模板(例如,使用 $variable$ 表示您的代码)。

      要保存自定义模板以供以后使用,请在对话框工具栏上点击 保存模板 图标(保存模板按钮)。 您也可以选择将该模板保存为检查。

      结构搜索对话框

      IntelliJ IDEA 会将创建的模板添加到模板列表中的 最近 节点。

    • 使用现有模板作为原型:从可用的现有模板列表中选择所需的模板。

      例如,您的代码中有以下字段:

      public class MainActivity { public static final String this_is_wrong = "Hello"; public static final String THIS_IS_CORRECT = "world"; }

      让我们在类中找到某个字段。

      在现有模板列表中,点击 Java 并打开 基于类 节点(因为我们需要类中的字段),因此 类的字段 模板将是我们的目标。

      现有模板列表

      点击 查找 ,在整个项目中搜索这些结构。

      IntelliJ IDEA 会在编辑器中立即高亮显示找到的代码出现位置。

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

    编辑筛选器
  4. 在此示例中,为 文本 变量添加一个 $Field$ 修饰符。

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

    \b[A-Z].*?\b
    在过滤器对话框中添加正则表达式

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

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

    例如,请查看以下选项:

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

    • 目标 :使用该列表选择要搜索的项。 在此情况下,它为 Field。

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

    • 注入的代码 :选中后,诸如 HTML 中的 JavaScript 或 Java 中的 SQL 等注入的代码将包含在搜索中。

    • 区分大小写 :选中后,搜索结果将与搜索目标的大小写匹配。

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

  7. 点击 查找。

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

    查找工具窗口结果

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

替换一个目标结构

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

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

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

  4. 在过滤器区域中,根据您选择的 过滤器 ,指定条件。

    例如,我们拿一个变量 $Field$ ,然后我们 搜寻并添加一个条件,以将找到的模板替换为小写字符。

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

    替换模板
  5. 要缩小替换结果,请选择以下选项:

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

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

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

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

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

    您还可以将替换模板添加到 结构化查找检查中,并将其用作代码的快速修复。

    带有替换预览的 Find 工具窗口

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

    替换结果

共享搜索模板

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

  1. 在 结构搜索 对话框 编辑 | 查找 | 结构化搜索 中, 创建一个新的搜索模板或使用现有的模板。

  2. 要导出模板,请点击 “导出模板到剪贴板”图标。 IntelliJ IDEA 将模板的 XML 表示添加到剪贴板(按 Ctrl+Shift+V 以查看剪贴板内容)。 您可以在聊天、电子邮件或论坛中与其他开发者共享此表示形式。

    要导入模板,请从任何地方(电子邮件、聊天或论坛)复制(Ctrl+C )共享的 XML 代码,并在 结构搜索 对话框中点击 从剪贴板导入模板图标。 IntelliJ IDEA 接受 XML 代码表示并将其转换为模板,包括变量和作用域(如果存在)。

2026年 11月 3日