PyCharm 2025.3 Help

结构搜索与替换对话框

使用这些对话框查找并替换在结构上与建议的 搜索模板 匹配的代码片段。

说明

适用于

搜索模板

使用此文本区域指定 模板, PyCharm 将基于该模板执行搜索过程。 您可以在该字段中键入模板代码,或点击 设置按钮 并选择 现有模板 选项以查看现有模板列表。

两者

区分大小写

如果您希望 PyCharm 匹配您要搜索的代码的大小写,请选中此复选框。

两者

文件类型

使用此选项为搜索选择文件类型。 在这种情况下, PyCharm 只在指定的文件类型中搜索。

两者

筛选图标

点击此图标可为整个搜索模板添加 修饰符。 使用 添加图标 添加新的修饰符,或使用 移除图标 删除现有修饰符。

两者

设置图标

点击此图标以选择以下选项之一:

  • 保存模板 :使用此选项保存您在搜索模板区域中指定的模板。 PyCharm 会将保存的模板添加到 现有模板 对话框中的 用户定义 节点。

  • 将模板导出到剪贴板 :使用此选项 导出模板 并共享。

  • 将模板导入到剪贴板 :使用此选项 导入共享模板

  • 现有模板 :使用此选项查看现有模板列表。

    现有模板 对话框中,选择预定义或自定义模板之一。 所选模板显示在 预览 字段中。 当您点击 确定 时, PyCharm 会将该模板的源代码插入到 搜索模板替换模板 字段中。

  • 切换到搜索/切换到替换 :使用此选项可快速切换到 结构化搜索结构化替换 对话框。

两者

替换模板

使用此文本区域指定用于替换的 模板。 您可以在该字段中键入模板代码,或点击 设置按钮 并选择 现有模板 选项以查看现有模板列表。

结构替换

搜索

点击此图标可查看您之前的搜索列表。

两者

缩短完全限定名

当模板文本包含完全限定的类名时,此选项才有意义。 如果选中该复选框, PyCharm 会自动缩短模板中的这些名称。 否则,将使用完全限定的类名。

结构替换

重新格式化

如果您希望 PyCharm 根据您的代码样式设置自动重新格式化展开的代码片段,请选中此选项(有关更多信息,请参阅 代码风格 对话框)。 如果未选中该选项, PyCharm 只会根据其在代码中的展开位置缩进整个模板,保持其格式不变。

结构替换

使用静态导入

如果您希望 PyCharm 缩短替换后的代码中对静态元素的任何引用,请选中此选项。 PyCharm 将为这些元素插入静态导入。 随后,这些元素将通过其短名称进行引用。 如果替换后的代码中没有对静态元素的引用,则会忽略该选项。

结构替换

范围

使用此区域指定 PyCharm 应在何处搜索并替换您的代码。

您可以从以下选项中进行选择:

  • 项目 :当您选择此选项时, PyCharm 会在整个项目中搜索并替换指定的模板。

  • 模块 :当您选择此选项时, PyCharm 会在所选模块中搜索并替换指定的模板。

  • 目录 :当您选择此选项时, PyCharm 会在所选目录中搜索并替换指定的模板。

  • 范围 :当您选择此选项时, PyCharm 会在您选择的特定范围内搜索并替换指定的模板。 您可以从可用列表中选择预定义范围,或点击 浏览按钮 创建 自定义范围

两者

搜索目标

使用此选项指定搜索过程的目标,可以是您指定模板的精确匹配(完全匹配 ),也可以只是其一部分。 搜索目标的可用选项取决于您所选的文件类型。

两者

在新选项卡中打开

如果选中此复选框,新搜索的结果将显示在查找结果工具窗口中的新选项卡中。 否则,搜索结果会更新现有选项卡。

两者

最后修改日期: 2025年 12月 2日