JetBrains Rider 2025.2 Help

代码语法样式:多属性

在 C# 中,多个 属性可以以不同的方式编写:您可以在同一个方括号节中合并多个属性,也可以为不同的属性使用多个节。 ReSharper 允许您为多个属性指定样式,并在所需范围内强制执行此样式。

JetBrains Rider 还为属性提供了多个 格式化规则。 您可以在 Rider 设置中配置这些规则 Ctrl+Alt+S ,例如,转到 编辑器 | 代码样式 | C# 页面并检查 换行和换行规则 选项卡上的偏好。

JetBrains Rider 帮助您在现有代码中应用属性样式,并在使用 代码补全代码生成功能生成新代码时考虑您的偏好,应用 代码模板并执行 重构

应用属性的样式偏好

默认情况下,会检查多个属性是否符合您的 首选项 ,如果不符合,JetBrains Rider 会突出显示这些声明,并建议相应的 快速修复范围内修复

您的偏好可能要求属性应位于单独的部分中:

多属性快速修复

…或者在一个单独的部分中:

多属性快速修复

另一种以批量模式强制执行多属性偏好的选项是 代码清理。 您可以使用内置的配置文件之一 运行代码清理 ,例如 完全清理重新格式化并应用语法样式 ,或者创建并运行 仅针对特定任务的自定义配置文件 ,如下所述。

使用自定义代码清理配置文件应用属性样式

  1. 按下 Ctrl+Alt+S 或从菜单中选择 文件 | 设置 (Windows 和 Linux)或 JetBrains Rider | 首选项 (macOS)。

  2. 转到代码清理配置文件设置页面: 编辑器 | 代码清理

  3. 按照 创建新的自定义清理配置文件 部分中描述的步骤创建一个新配置文件。 在新配置文件的 选定的配置文件设置 部分中,勾选 添加/移除多个特性的中括号 复选框。 您还可以选择在此配置文件中启用其他代码清理任务。

  4. 在 设置 对话框中点击 保存 以应用修改,并让 JetBrains Rider 选择保存位置,或者通过从 保存 选择器中选择特定设置层来保存修改。 如需了解更多信息,请参见 基于层的设置

  5. 选择您希望强制执行偏好的范围:

    • 将光标放置在文件中的任意位置,以对文件强制执行您的偏好设置。

    • 解决方案资源管理器 中选择一个或多个项目,以对这些节点及其子项下的文件强制执行您的偏好设置。

  6. Ctrl+R, C 或从主菜单中选择 代码 | 格式化和清理…

  7. 在打开的 重新格式化并清理代码 对话框中,选择新创建的配置文件,并根据需要选择另一个范围。 在打开的 重新格式化并清理代码 对话框中,选择新建的配置文件,并在需要时选择其他作用域。

  8. 点击 确定。 JetBrains Rider 将在选定范围内强制执行您的偏好设置。

如果您希望在不打开 重新格式化并清理代码 对话框选择配置文件的情况下应用属性样式,可以将创建的配置文件绑定到 静默清理 ,并通过按 Ctrl+R, G 运行它。 您还可以创建一个 自定义清理配置文件 ,将应用属性样式与其他代码样式任务结合起来。

要将多属性的偏好与所有其他 格式化语法样式规则一起应用于选定的代码块, Alt+Enter 并选择 格式化和清理 | 格式化&应用语法样式

您可以在最近修改并准备提交到 Git 的代码中应用属性样式。 JetBrains Rider 将在提交之前运行选定的 清理配置文件

在提交到 Git 之前清理代码

  1. Ctrl+K 或从主菜单中选择 Git| 提交(I)

  2. 提交 工具窗口中,点击 显示提交选项 ,并在 提交检查 区域中,选择 清理方式... 复选框。

  3. 点击 选择配置文件 并选择您的自定义 Code Cleanup 配置文件。

  4. 点击 提交提交并推送。 JetBrains Rider 将在提交暂存的文件中运行代码清理,然后提交更改。

您可以在每次保存文件更改时应用属性样式,以确保您的编辑始终符合代码样式。 请注意,这仅在您通过 Ctrl+SCtrl+S 显式保存更改时发生,不会因 自动保存 而触发。 然而,所有自动保存的文件都会被放入“重新格式化和清理”队列,并将在下次显式保存时处理。

在保存更改时自动应用属性样式

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 工具 | 保存时的操作

  2. 选择 重新格式化并清理代码 ,选择您的自定义 Code Cleanup 配置文件,并决定是将其应用于整个文件还是仅应用于更改的行。

  3. 下次您完成编辑并保存文件或所有文件时,JetBrains Rider 将使用选定的配置文件清理受影响的文件。

配置属性样式的偏好

您的属性样式偏好是通过 基于层的设置机制保存的。 此外,该机制允许您为不同的解决方案维护不同的偏好,并将这些偏好保存在 VCS 中,自动与团队成员共享。

配置属性样式的偏好

  1. 转到 JetBrains Rider 设置 的 编辑器 | 代码样式 | C# 页面 Ctrl+Alt+S ,然后选择 语法样式 选项卡。

  2. 属性 类别中,根据您的编码实践/标准选择 在部分中联接或分隔特性 的值。

  3. 右侧列中的选择器允许您设置检测与您的偏好设置不一致代码的 严重性级别代码检查

  4. JetBrains Rider 还为属性提供了多个 格式化规则。 您可以在 Rider 设置中配置这些规则 Ctrl+Alt+S ,例如,转到 编辑器 | 代码样式 | C# 页面并检查 换行和换行规则 选项卡上的偏好。

  5. 在 设置 对话框中点击 保存 以应用修改,并让 JetBrains Rider 选择保存位置,或者通过从 保存 选择器中选择特定设置层来保存修改。 如需了解更多信息,请参见 基于层的设置

您还可以直接在编辑器中更改排列多属性的偏好,其中相应的问题会被高亮显示:

从编辑器更改显式/隐式修饰符的偏好

  1. 将插入符号放置在 一个 JetBrains Rider 的检查高亮显示的代码问题上。

  2. Alt+Enter 或点击光标左侧的 操作指示器 以打开 操作列表

  3. 在操作列表中,选择 检查“在部分中合并或分离属性” | 配置代码样式 ,然后选择所需的选项:

    在编辑器中更改排列多属性的偏好
  4. 您的更改将使用 智能保存 逻辑保存。

  5. 如果您需要将修改后的样式偏好保存到 共享设置层 中,请点击 配置代码样式 菜单项或在选中时按 输入 。 JetBrains Rider 将打开 JetBrains Rider 设置 的 编辑器 | 代码样式 | C# | 语法样式 页面,您可以根据需要修改偏好,点击 保存到 ,然后选择所需的设置层。

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