JetBrains Rider 2025.2 Help

代码样式

方案

在此区域,选择 代码样式方案并根据需要进行更改。 每当 JetBrains Rider 生成、重构或重新格式化您的代码时,代码样式方案的设置都会自动应用。

这个IDE带有两个预定义的方案: 项目 方案和 默认 方案。

  • 项目 方案中,您配置的设置仅适用于您当前的项目。

    这些设置存储在 代码样式 文件夹下的 .idea 中,并通过 VCS 与项目一起共享。

    在您为项目修改代码样式设置后,IDE 将创建文件夹。

  • 默认 方案(IDE级别的方案)中,您配置的设置将应用于所有已选择 默认 代码样式方案的现有项目。

    这些设置存储在 代码样式 文件夹中的 JetBrains Rider 配置目录 ,并且不会通过 VCS 共享。

如果您想将项目代码样式方案用作您的默认方案,您可以将其复制到 IDE 级别。 另一种方式也是可行的:您可以使用 IDE 级别方案中的设置覆盖您当前的项目设置,并与您的团队其他成员共享。

条目

描述

方案

从此列表中,选择要使用的方案。 预定义的 方案以粗体显示。 自定义 方案,即预定义方案的副本,都是纯文本。 方案存储的位置会写在每个方案旁边,例如, 默认 方案是存储在 IDE 中, 项目 方案是存储在项目中。

显示方案操作

点击此按钮以调用用于管理方案的命令列表:

  • 复制到IDE… :选择此选项将方案设置复制到 JetBrains Rider 。

  • 导出 :选择此选项以 IntelliJ IDEA 代码样式 XMLEditorConfig 格式导出所选方案(如果启用了 EditorConfig 插件)。

  • 导入方案 :选择此选项以从指定位置导入选定类型的方案。

  • 复制项目: 选择此选项可用所选IDE代码样式方案的设置覆盖您当前的项目代码样式设置。

  • 复制… :选择此选项以创建选定方案的副本。

  • 重置 :选择此选项,将默认或捆绑的配色方案重置为与 JetBrains Rider 一起提供的初始默认设置。 只有当一些更改已经完成时,此命令才会变为可用。

  • 重命名 :选择此选项可更改所选自定义方案的名称。 按下 Enter 以保存更改,或 Escape 以取消。

常规

行分隔符

JetBrains Rider 允许您为各种语言配置行分隔符和缩进选项。 在 重新格式化源代码时,JetBrains Rider将应用指定的缩进行为,并跳过用特殊格式关/开标记标注的部分。

条目

描述

行分隔符

使用此列表来指定由 JetBrains Rider 创建的文件中要使用哪个 行分隔符。 可用选项包括:

  • 取决于系统 :选择此选项以使用适用于您的操作系统的默认分隔符。

  • Unix 和 macOS (\n) :选择此选项以使用 Unix 和 macOS 行分隔符。

  • Windows (\r\n) :选择此选项以使用 Windows 行分隔符。

  • Classic Mac OS (\r) :选择此选项以使用 \r 行分隔符,该分隔符在 Classic Mac OS (直至 Mac OS 9)中使用过。

强制换行位置

在此字段中,指定用于在编辑器中显示页面的列数。

键入时换行

选择此复选框,以确保编辑过的文本始终适应指定的右边距。

视觉参考线

在此字段中,指定多个右边距。 您可以保留默认值,或者输入您的边距所需的空格数。 如果您想要指定多个边距,请输入由顿号分隔的数字。

缩进检测

选择 检测并使用现有的文件缩进进行编辑 检测当前文件的 缩进样式 ,并使用此样式来替代特定语言在代码样式设置中指定的缩进。

在 C# 中,当您在文件中 重新格式化 部分代码或在编辑或粘贴时代码被 自动格式化 时,JetBrains Rider 可以根据该文件其余部分的现有缩进计算并应用缩进。

对于非 .NET 语言的文件,JetBrains Rider 会在编辑器的状态栏中显示缩进信息。 您可以点击缩进信息以查看可用操作,例如启用或禁用此选项,并将当前缩进更改为 代码样式 设置中为特定语言指定的缩进。

代码样式配置文件

启用 EditorConfig 支持

EditorConfig 是一种配置文件约定,用于在团队成员之间以及他们可能使用的不同 IDE 之间定义和维护一致的代码样式。 这些样式保存在名为 .editorconfig 的类似 INI 的文件中,其中部分名称是文件掩码,部分中的属性定义了与这些掩码匹配的文件的代码样式。

使用此复选框使 JetBrains Rider 遵循在 EditorConfig 配置文件中定义的代码格式化样式。 有关更多信息,请参见 使用 EditorConfig

导出

点击此按钮以 将代码样式从 JetBrains Rider 设置导出到 .editorconfig 文件

启用 StyleCop 支持

启用 StyleCop 集成时,StyleCop 配置文件( RuleSet Settings.StyleCop )中的设置将覆盖 JetBrains Rider 的 代码格式化代码语法 样式,并启用相应的代码检查。

如果您的项目中安装了 StyleCop.Analyzers NuGet 包,JetBrains Rider 还会读取并应用 StyleCop Analyzers 样式的默认值。 这些值将优先于 JetBrains Rider 设置中的相应样式,但如果有配置文件中的值,它们将被覆盖。

如果您同时使用 EditorConfig 和 StyleCop 配置文件,StyleCop 设置将始终优先于 EditorConfig 属性 和 JetBrains Rider 设置。

格式化器

条目

描述

不设置格式

不设置格式 字段中,指定包含您想从 重新格式化代码排列导入优化中排除的文件和目录名称的 glob pattern ,例如: *.{html,htm}

您可以指定用分号 分隔的几个通配符模式。

使用星号 * 通配符来完全禁用重新格式化。

在代码注释中使用标记打开/关闭格式化程序

  • 如果启用此选项,将根据这些标记重新格式化带有格式化标记的行注释之间的代码片段:带有开启标记的代码片段将被重新格式化,而带有关闭标记的片段在您重新格式化代码后将保持不变。

    在您勾选此复选框后,下方的字段将变为可用状态,您可以指定需要被视为格式标记的字符串。

  • 如果禁用此选项,将忽略格式标记,带标记的行注释之间的代码将被重新格式化。

关:

在此字段中,指定将表示您希望从重新格式化中排除的代码片段起始的字符字符串。 在前置词中键入带有 @ 符号的字符字符串,或保留预定义的值 @formatter:off

开:

在此字段中,指定将表示要从重新格式化中排除的代码片段结束的字符字符串。 在前置词中键入带有 @ 符号的字符字符串,或保留预定义的值 @formatter:on

在格式化程序标记中启用正则表达式

选择此复选框,使用正则表达式替代显式指定的格式标记。 JetBrains Rider 会使用指定的正则表达式来匹配格式化开/关标记,而不是精确的字符串。

例如,使用正则表达式可以让您有多个启用格式化器和禁用它的标记。 在这种情况下,您可以使用以下正则表达式: @formatter:(off|disable|no)@formatter:(开启|是)

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