ReSharper 2025.3 Help

添加/编辑/搜索突出显示模式对话框

此对话框有助于创建和编辑自定义模式,这些模式可以检测与特定模式匹配的代码,并在必要时替换这些代码。

本主题描述了对话框中的控件。 有关使用自定义模式搜索和替换代码的更多信息,请参阅 结构化搜索和替换创建自定义代码检查和快速修复

此对话框可以以两种模式打开。

  • 当您使用 ReSharper | 查找 | 使用模式搜索 命令时(该命令在编辑器的上下文菜单中重复),对话框以 搜索/替换模式 打开,允许您直接从对话框底部使用相应的按钮开始搜索或替换。

  • 当您在 ReSharper 选项的 代码检查 | 自定义模式 页面上使用 添加模式/编辑 按钮时,对话框以 模式编辑模式 打开,提供用于指定模式描述的附加字段。 然而,在此模式下, 搜索/替换 按钮不可用。

编辑突出显示模式对话框

语言选择器

允许选择模式的编程语言。 ReSharper 只会在指定的语言中找到匹配的代码。

查找/替换

使用这些选择器显示或隐藏替换模式。

ThemedIcon.PatternsCatalogue.Screen.(Gray).png模式目录

单击以打开 ReSharper 选项的 代码检查 | 自定义模式 页面并查看现有模式列表。

ThemedIcon.Pattern.Screen.(Gray).png最近搜索

单击以展开最近使用的自定义模式列表。

搜索区域

搜索模式

使用此编辑器通过纯文本和 占位符 输入您自己的搜索模式。

查找范围 (在搜索/替换模式下可用)

使用此列表指定以下搜索范围之一:

  • 整个解决方案

  • 当前项目

  • 当前文件

模式严重性 (在模式编辑模式下可用)

如果您将模式用作 自定义代码检查 ,您可以使用列表指定其 严重性级别

匹配相似结构

使用此控件指定是否匹配相似的结构。

ReSharper 将以下结构视为相似:

  • 单行语句和用大括号括起来的单行语句。

  • 二元表达式按模式指定的顺序和反向顺序。

  • 按模式指定的表达式和操作数顺序不同的表达式。

  • 操作数用括号括起来的表达式和操作数未用括号括起来的表达式。

  • 后缀和前缀递增运算符。

  • 具有不同访问修饰符的方法。

禁止键

如果您为模式指定了抑制键,您将能够通过注释 抑制 ReSharper 检查 ,检测到模式的使用,例如:

// ReSharper disable once [SuppressionKey]

.

如果您希望通过单个注释抑制多个模式的检查,您可以为所有这些模式指定相同的抑制键。

注释 (在模式编辑模式下可用)

此字段可选地让您指定在 ReSharper 选项的 代码检查 | 自定义模式 页面上显示的模式描述。 如果您将模式用作 自定义代码检查 ,此描述将作为工具提示出现在编辑器中 突出显示相应问题 时,以及在 检查结果 中。

ReSharper 的自定义检查。 检查和快速修复的描述

替换区域

此区域包含帮助您创建替换模式并指定替换后操作的控件。 当您在对话框右上角选择 替换 时,此区域会出现。

替换模式

使用此编辑器通过纯文本和 占位符 输入替换模式。 您只能使用搜索模式中定义的占位符。

替换后格式化

指定是否对替换模式生成的代码应用格式化。

您可以在 ReSharper 选项 Alt+R, O 代码编辑 | 通用格式化样式 页面和/或在 代码编辑 | [语言] | 格式化样式 页面上配置代码格式设置。

缩短引用

指定是否将完全限定名称替换为短名称。

注释 (在模式编辑模式下可用)

此字段可选地让您指定在 快速修复 中显示的名称,如果您将模式用作 自定义代码检查

ReSharper 的自定义检查。 检查和快速修复的描述

占位符区域

添加占位符

单击此按钮以创建新的占位符。 有 5 种类型的占位符:

  • 参数占位符 — 方法调用中的一个或多个参数。 如有必要,您可以指定应匹配的参数的最小或最大数量。

  • 表达式占位符 — 一系列运算符和操作数。 您可以选择性地指定此表达式返回的类型。

  • 标识符占位符 — 任何符号标识符。 您还可以指定一个正则表达式,用于匹配符号名称。

  • 语句占位符 — 以分号结尾的单行语句或语句块。 如有必要,您可以指定应匹配的语句的最小或最大数量。

  • 类型占位符 — 值类型或引用类型。 默认情况下,此类占位符将匹配任何类型,但您可以显式指定特定类型。

单击此按钮时,将打开 创建占位符 对话框,您可以在其中选择占位符的类型、指定其名称和参数:

ReSharper:创建参数占位符

此对话框中可以使用以下控件:

  • 名称 — 指定占位符名称(适用于所有占位符)。

  • 限制最小参数/语句数量 — 定义占位符出现的最小次数(适用于参数和语句占位符)。

  • 最大值 — 定义占位符出现的最大次数(适用于参数和语句占位符)。

  • 表达式类型/类型 — 从列表中选择一个项目以指定占位符的类型(适用于表达式和类型占位符)。

  • 或派生类型 — 选中此复选框以匹配具有所选类型或其派生类型的表达式或类型(适用于表达式和类型占位符)。

  • 标识符名称正则表达式 — 定义标识符名称的正则表达式(适用于标识符占位符)。

  • 区分大小写 — 指定标识符是否区分大小写(适用于标识符占位符)。

编辑

单击此按钮或双击占位符名称以使用 创建/编辑占位符 对话框编辑选定的占位符。

删除

单击此按钮以删除选定的占位符。 请注意,您无法删除在搜索模式中使用的占位符。

命令按钮

查找 (在搜索/替换模式下,当替换模式隐藏时可用)

单击此按钮以执行搜索。

替换 (在搜索/替换模式下,当替换模式显示时可用)

单击此按钮以查找模式出现的位置并指定要替换的位置。

保存

单击此按钮以使用 智能保存 逻辑将当前模式保存到目录。 要稍后访问模式目录,请打开 ReSharper 选项的 代码检查 | 自定义模式 页面。

保存副本 (在模式编辑模式下可用)

单击此按钮以将当前模式的副本保存到目录。 如果您想创建一个与当前模式类似的新模式,这可能会很有帮助。 与“保存”命令类似,这里也适用 智能保存 逻辑。

关闭

单击此按钮以关闭对话框。

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