ReSharper 2026.3 Help

嵌入提示

内嵌提示是 可配置的 编辑器装饰,可提高代码的可读性。

按键提示模式

内嵌提示可能很有帮助,但另一方面,它们占用编辑器空间,在某些情况下可能显得多余。 要按需查看内嵌提示,您可以使用 按键提示 模式。 它允许您将提示隐藏,仅在需要时查看它们。

按下键时显示内嵌提示

  1. 确保应用程序焦点在编辑器中。

  2. 按下 Ctrl 两次并在第二次按下后保持。 Inlay hints will be shown as long as you hold the keys.

  3. 如果您希望在释放 Ctrl 键后继续显示内嵌提示,请单击编辑器右上角的相应图标:

    要停止显示内嵌提示,请再次单击 按住提示 图标。

如果您希望在所有编辑器选项卡中始终显示或隐藏内嵌提示,请在 ReSharper 选项 环境 | 内嵌提示 | 常规 页面中使用 默认可见性 选择器 Alt+R, O 。 无论您选择默认可见性如何,您都可以在 环境 | 内嵌提示 下的相应设置页面上为特定类型的提示覆盖此设置。

If the press-and-hold or double-press of the Ctrl key is already bound to some other actions in your OS or other applications , ReSharper will override those mappings even if you do not use Push-to-Hint. 为避免此问题,请在 ReSharper 选项 环境 | 内嵌提示 | 常规 页面中取消选中 为“一键提示”保留按两次 Ctrl 键并按住 复选框 Alt+R, O 。

形参名称提示

作为在方法调用中编写 命名参数 的替代方案,您可以利用 ReSharper 的 参数名称提示——编辑器装饰会在方法调用中将参数名称显示在相应参数旁边。

请考虑以下方法调用:

AddCheckbox(true, true, "AutoFill", null);

阅读此代码时,您必须停下来研究方法签名以了解发生了什么(您可以通过 参数信息工具提示 或 导航到方法声明 来完成此操作)。 使用参数名称提示,相同的调用变得更加清晰:

ReSharper:内联参数名称提示有助于理解方法调用中的参数

参数名称提示的理念是为意图可能不明确的参数显示参数名称,同时避免在参数目的显而易见的情况下使编辑器充满提示,当然如果调用中有命名参数也是如此。 为实现这一点,ReSharper 应用了许多 可配置的启发式规则。

类型名称提示

Type name hints help you understand the types that variables and expressions have in different contexts. 例如:

  • 匿名类型,

    ReSharper:内嵌提示。 长类型名称
  • lambda 表达式的参数,

    ReSharper:内嵌提示。 lambda 表达式参数
  • 调用链中方法的返回类型,

    ReSharper:内嵌提示在调用链中返回类型

以及许多其他情况。

如果需要,您可以为每种特定情况 配置 类型名称提示。

类型转换提示

类型转换提示显示代码中的隐式类型转换。

在下面的示例中,从 Vector3D 转换为 Vector2D 会悄悄丢失数据(Z 值),提示帮助我们看到这种情况发生的位置。

ReSharper:类型转换提示

If you see that a type conversion hint for a specific conversion is not helpful, you can disable conversion hints for all conversions involving those specific types. 为此,请将光标放在赋值运算符旁边,按下 Alt+Enter 并选择 配置内嵌提示 | 类型转换提示 | 隐藏...。 更改将被保存,您可稍后在 ReSharper 选项 环境 | 内嵌提示 | C# | 类型转换提示 页面 Alt+R, O 中查看或恢复该更改。

代码分析提示

您可以使用内嵌提示显示函数中缺少的返回值和 switch 语句中缺少的 break。 这使您可以立即了解具体缺少了什么:

ReSharper 内嵌提示:缺少返回值

您可以使用内嵌提示查看资源变量被释放的位置:

ReSharper 内嵌提示:已释放的资源变量

如果您使用 [MustDisposeResourceAttribute] (来自 JetBrains.Annotations )来 强制调用代码中的资源释放 ,ReSharper 可帮助您直观地识别返回可释放资源的构造函数和工厂方法:

ReSharper 内嵌提示:MustDisposeResourceAttribute

要配置这些提示的可见性,请在 ReSharper 选项 环境 | 内嵌提示 | C# | 其他 页面中使用相应的选择器 Alt+R, O 。

C# 拦截器的内嵌提示

Inlay hints will help you spot intercepted calls, with the additional ability to navigate to the interceptor method with Alt+Enter or with Ctrl +click the hint icon:

ReSharper:拦截方法的内嵌提示和导航操作

拦截器方法上的 [InterceptsLocation] 注解有一个提示,允许您导航到被拦截的调用:

ReSharper:拦截方法的内嵌提示和导航操作

要配置这些提示的可见性,请在 ReSharper 选项 环境 | 内嵌提示 | C# | 拦截器提示 页面中使用相应的选择器 Alt+R, O 。

未命名结构的内嵌提示

当元组组件名称无法从组件表达式中明显看出时,您可以将其作为内嵌提示查看:

ReSharper:元组组件名称的内嵌提示

内嵌提示可以通过显示解构模式组件的声明名称,大大提高代码的可读性:

ReSharper:解构模式组件名称的内嵌提示

当方法返回的变量多于所需变量,并且某些变量被 _ 丢弃时,内嵌提示可以帮助您看到被丢弃的内容。 By default, hints for discards work with push-to-hint:

ReSharper:丢弃名称的内嵌提示

要配置这些提示的可见性,请在 ReSharper 选项 环境 | 内嵌提示 | C# | 其他 页面中使用相应的选择器 Alt+R, O 。

'#pragma warning' 提示

#pragma warning 指令允许您通过其 ID 禁用和恢复特定警告。 很难记住每个 ID 的含义,因此 ReSharper 可以添加带有警告描述的内嵌提示。 Note that this kind of hint only works with compiler warnings, whose IDs start with CS.

ReSharper:'#pragma warning' 指令的内嵌提示

要配置这些提示的可见性,请在 ReSharper 选项 环境 | 内嵌提示 | C# | 其他 页面中使用相应的选择器 Alt+R, O 。

尾随局部函数提示

在代码块末尾放置局部函数是一种常见做法,但在阅读此类代码块时,您通常需要滚动浏览局部函数定义,以确保它们之后没有可执行代码。

To improve readability in such cases, ReSharper offers inline hints that either visualize the implicit control flow markers such as return; and continue, or show //Local Functions if there is no more executable code in the block.

ReSharper:尾随局部函数的内嵌提示

要配置这些提示的可见性,请在 ReSharper 选项 环境 | 内嵌提示 | C# | 其他 页面中使用相应的选择器 Alt+R, O 。

闭括号提示

当您处于大型代码块的末尾时,通常不清楚闭括号代表什么:它可能表示嵌套类型、方法或复杂语句的结束。 Inlay hints can clarify the code structure by showing what exactly each closing brace is the end of:

ReSharper:闭括号的内嵌提示

为减少视觉干扰,这些提示仅出现在超过 10 行的代码块中,并且仅当您的光标位于闭括号时才会显示。

要启用或禁用这些提示,请在 ReSharper 选项 环境 | 编辑器 | 外观 页面中使用 使用内嵌提示显示匹配块的头部... 复选框 Alt+R, O 。

配置内嵌提示

您可以在 ReSharper 选项 环境 | 内嵌提示 页面下的相应设置页面中切换和配置内嵌提示 Alt+R, O 。

如果不使用内嵌提示,可以在 环境 | 内嵌提示 | 常规 设置页面取消选中 启用内嵌提示 复选框来禁用。 ReSharper 将停止计算提示,从而节省一些资源。

但是,如果您只想查看某些特定类型的提示,可以在该页面上将 默认可见性 选择器设置为 从不显示 ,然后使用可见性选择器覆盖所需类型的提示。

对于 参数名称提示 ,您还可以在匹配特定模式的方法中隐藏提示。 为此,请在 ReSharper 选项 环境 | 内嵌提示 | [语言] | 参数名称提示 页面底部添加这些模式 Alt+R, O 。

以下是一些模式示例:

  • System.Math.* 匹配所有 FQN 以 System.Math 开头的方法

  • System.Math.*(*, *) 匹配 System.Math 命名空间中具有两个参数的所有方法

  • (*info) 匹配所有单参数方法,其中参数名称以 info 结尾

  • (key, value) 匹配所有具有参数 key 和 value 的方法

  • Put(key, value) 匹配所有 Put 方法,参数为 key 和 value

当您的光标位于具有内嵌提示的代码项时,您可以按下 Alt+Enter ,选择 配置内嵌名称提示 ,或者右键单击参数提示,然后选择以下命令之一:

  • 隐藏方法的所有调用的参数提示,或适用于当前项的类型名称提示(如果您想显示已禁用的提示,可以在选项页面中找到相应的项或异常模式并将其移除),

  • 更改此类提示的可见性,

  • 完全禁用内嵌提示(您可以稍后在选项页面中启用它们),

  • 或打开选项页面进行详细配置。

ReSharper:通过 Alt+Enter 菜单配置参数名称提示

如果您右键单击 参数名称、 类型名称 或 类型名称 提示,您还可以导航到相应类型或参数声明的声明:

ReSharper:通过 Alt+Enter 菜单配置参数名称提示

您还可以使用 Control+Alt+Shift+5 快捷键或从 状态指示器 的上下文菜单中切换当前解决方案中的参数名称提示:

ReSharper:通过状态指示器切换参数名称提示

您可以配置内联提示的颜色和字体大小——字体大小可在 ReSharper 选项 的 环境 | 内嵌提示 | 常规 页面 Alt+R, O 上进行设置,字体颜色可在 Visual Studio 选项中设置:转到 工具 | 选项 | 环境 | 字体和颜色 ,并在显示项列表中找到 ReSharper 内嵌提示。

在不同语言中的适用性

此功能在以下语言和技术中是 支持的:

语言:C#

语言:VB.NET

语言:C++

语言:ASP.NET

语言:Razor

语言:XAML

语言:Resx

语言:构建脚本

语言:SQL

功能在 C# 中可用

此功能适用于 Visual Basic

C++ 中的内嵌提示

功能在 ASP.NET 中不可用

功能在 Razor 中不可用

XAML 中的内嵌提示

此功能不适用于资源文件

此功能不适用于构建脚本文件

功能在 SQL/NoSQL 文件和注入中不可用

此处提供的说明和示例介绍了在 C# 中使用该功能。 有关其他语言的更多信息,请参阅 语言和框架 部分中的相关主题。

2026年 11月 6日