JetBrains Rider 2025.2 Help

嵌入提示

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

Push-to-Hint 模式

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

按下键时显示内嵌提示

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

  2. 按下 Ctrl 两次,并在第二次按下后保持按住。 只要按住键不放,就会显示内联提示。

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

    JetBrains Rider:为当前文件固定内嵌提示

    要停止显示内嵌提示,请再次单击 推送到提示 装饰。

如果您希望在所有编辑器选项卡中始终显示或隐藏内联提示,请在 JetBrains Rider 设置 Ctrl+Alt+S编辑器 | 内联提示 页面上使用 默认可见性 选择器。 无论默认可见性如何,您都可以在 编辑器 | 内联提示 下的相应设置页面中为特定类型的提示单独配置可见性。

如果 Ctrl 键的按住或双击操作已绑定到您的操作系统或其他应用程序中的其他操作,JetBrains Rider 将覆盖这些映射,即使您不使用按键提示。 要避免这种情况,请在 JetBrains Rider 设置 Ctrl+Alt+S编辑器 | 内联提示 页面取消选中 为“一键提示”保留按两次 Ctrl 键并按住 复选框。

形参名称提示

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

请考虑以下方法调用:

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

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

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

参数名称提示的理念是为意图可能不明确的参数显示参数名称,但同时不会在参数目的显而易见的地方用提示使编辑器变得杂乱,当然如果调用中有命名参数也是如此。 为实现此目的,JetBrains Rider 应用了许多 可配置的启发式方法

类型名称提示

类型名称提示帮助您理解变量和表达式在不同上下文中的类型。 例如:

  • 匿名类型,

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

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

    JetBrains Rider:内嵌提示显示调用链中的返回类型

以及许多其他情况。

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

类型转换提示

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

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

JetBrains Rider:类型转换提示

如果您发现某个特定转换的类型转换提示不是很有帮助,您可以禁用涉及这些特定类型的所有转换提示。 为此,请将光标放在赋值运算符旁边,按下 Alt+Enter 并选择 配置内嵌提示 | 类型转换提示 | 隐藏条件...。 更改将被保存,稍后您可以在 JetBrains Rider 设置 Ctrl+Alt+S编辑器 | 内嵌提示 | C# | 类型转换提示 页面查看或还原它。

代码分析提示

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

JetBrains Rider 内嵌提示:缺少返回值

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

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

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

JetBrains Rider 内嵌提示:MustDisposeResourceAttribute

要配置这些提示的可见性,请使用 JetBrains Rider 设置 的 编辑器 | 内联提示 | C# | 其他 页面上的相应选择器 Ctrl+Alt+S

C# 拦截器的内嵌提示

内嵌提示将帮助您发现 拦截的调用 ,并提供额外的功能,通过 Alt+Enter Ctrl +单击提示图标导航到拦截器方法:

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

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

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

要配置这些提示的可见性,请使用 JetBrains Rider 设置 的 编辑器 | 内联提示 | C# | 拦截器提示 页面上的相应选择器 Ctrl+Alt+S

未命名结构的内嵌提示

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

JetBrains Rider:元组组件名称的内嵌提示

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

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

当方法返回的变量多于所需变量,并且某些变量被 _ 丢弃时,内嵌提示可以帮助您看到哪些变量被丢弃。 默认情况下,丢弃提示通过 push-to-hint 工作:

JetBrains Rider:丢弃名称的内嵌提示

要配置这些提示的可见性,请使用 JetBrains Rider 设置 的 编辑器 | 内联提示 | C# | 其他 页面上的相应选择器 Ctrl+Alt+S

“#pragma warning” 提示

#pragma warning 指令允许您通过其 ID 禁用和恢复特定警告。 很难记住每个 ID 的含义,因此 JetBrains Rider 可以添加带有警告描述的内嵌提示。 请注意,这种提示仅适用于 ID 以 CS 开头的编译器警告。

JetBrains Rider:“#pragma warning” 指令的内嵌提示

要配置这些提示的可见性,请使用 JetBrains Rider 设置 的 编辑器 | 内联提示 | C# | 其他 页面上的相应选择器 Ctrl+Alt+S

配置内嵌提示

您可以在 JetBrains Rider 设置 Ctrl+Alt+S编辑器 | 内联提示 页面下的相应设置页面中切换并配置内联提示。

如果您不使用内嵌提示,可以通过清除 JetBrains Rider 设置 的 编辑器 | 内联提示 | 常规 设置页面上的 在 .NET 语言中启用内嵌提示 复选框来禁用它们。 JetBrains Rider 将停止计算提示,从而节省一些资源。

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

对于 参数名称提示 ,您还可以隐藏与特定模式匹配的方法中的提示。 为此,请将这些模式添加到 JetBrains Rider 设置 的 Ctrl+Alt+S 页面底部的 编辑器 | 内嵌提示 | [language] | 参数名称提示

以下是一些模式示例:

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

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

  • (*信息) 匹配所有参数名称以 信息 结尾的单参数方法。

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

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

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

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

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

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

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

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

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

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

您可以在 编辑器|配色方案|语言默认值 设置页面  Ctrl+Alt+S 上配置内嵌提示的颜色 — 选择 内联参数提示 | 默认 项。

最后修改日期: 2025年 9月 26日