语法样式
代码样式的一个方面是如何使用可互换的语言语法结构。 例如,以下两个方法定义从编译器的角度来看是相同的,但语法结构的选择使它们看起来不同:
[Conditional("DEBUG")]
[Test]
static public void Foo(String str)
{
foreach (Char ch in str)
{
System.Console.WriteLine(value: ch);
}
}
|
[Test, Conditional("DEBUG")]
public static void Foo(string str)
{
foreach (var ch in str)
Console.WriteLine(ch);
}
|
配置代码语法样式
当您开始使用 ReSharper 时,它将参考其默认设置,以确保在整个代码库中一致地使用可互换的语法结构。 但是,您可以根据自己的喜好配置每个单独的首选项。 有两种方法可以配置代码语法样式:
在 ReSharper 选项 的 页面上配置您的首选项 Alt+R, O 。 这些修改将使用 分层设置的机制保存,以便您可以在本地机器上将其应用于所有项目,或与您的团队成员共享。
使用 ReSharper 自定义 EditorConfig 代码样式属性 ,在 EditorConfig文件中指定您的首选项,这也将使您的团队拥有一致的代码样式。
请注意,在 .editorconfig 文件中指定的首选项将 覆盖保存在 ReSharper 设置中的首选项。
为选定代码配置代码语法样式规则
作为浏览设置页面的替代方法,您可以选择一段代码,仅配置适用于该段代码的代码语法样式规则。 您将能够直接在编辑器中观察修改后的设置如何影响选定的代码块。
在编辑器中,选择您希望应用代码语法样式的代码块。
按 Alt+Enter 并选择 。
在打开的对话框中,您将看到影响选定代码块的所有语法样式和格式化规则。 代码块本身将被虚线框包围:

当您更改代码语法样式规则时,您将看到它们如何影响选定的代码块。
在对话框中单击 保存 以应用修改,并让 ReSharper 选择保存位置,或者通过从 保存到 选择器中选择特定的设置层来保存修改。 有关更多信息,请参见 管理和共享 resharper 设置。
请注意,您还可以选择 将配置的代码语法样式规则导出到 EditorConfig ,方法是选择 .editorconfig 在 保存到 选择器中。
可选地,您可以单击 另存为注释。 通过这种方式,您的修改将以 注释的形式保存在选定块的前后。 这使您可以在本地覆盖所需的代码语法样式规则,而无需修改任何设置。
ReSharper 将关闭对话框并在代码块中应用修改后的代码语法样式规则。
从现有代码中学习代码语法样式规则
调整单个代码语法样式首选项的另一种方法是从现有代码示例中学习代码语法样式规则,该示例可以是选定的块、当前文件、一组文件、一个或多个项目或整个解决方案。 ReSharper 将分析选定的示例,并列出与您当前设置不同的代码语法样式规则。 然后,您可以查看检测到的规则,根据需要更改它们,并将其保存到所需的 设置层或 .editorconfig或 .clang-format格式的配置文件中。
选择您希望分析代码语法样式设置的范围:
在编辑器中选择一段内容以分析选定内容中的代码语法样式设置。
将光标放置在文件中的任意位置以分析文件中的代码语法样式设置。
执行以下操作之一:
从主菜单中选择 。
如果代码示例是选定内容,请按 Alt+Enter 并选择 。
查看与您当前设置不同的规则:

在对话框中单击 保存 以应用修改,并让 ReSharper 选择保存位置,或者通过从 保存到 选择器中选择特定的设置层来保存修改。 有关更多信息,请参见 管理和共享 resharper 设置。
如果代码示例是选定内容,您可以选择单击 另存为注释。 通过这种方式,您的修改将以 注释的形式保存在选定块的前后。 这使您可以在本地覆盖所需的代码语法样式规则,而无需修改任何设置。
通过代码检查检查并修复代码语法样式
ReSharper 提供了一些 代码检查 ,用于检查您的代码是否符合代码语法样式,并在样式被违反时建议 快速修复 ,例如,如果 修饰符顺序与您的首选项不同:

如果您需要查看所需范围内的所有代码语法样式问题,甚至是整个解决方案,您可以在该范围内 运行代码检查。 分析完成后,按问题类别对结果进行分组,并检查存在的问题及其位置:

所有代码语法样式检查都是可配置的,您可以 禁用您不喜欢的检查。
您还可以浏览代码语法样式检查列表,并一次性配置所有检查。 有两种方法可以做到这一点:
在 ReSharper 选项 的 页面 Alt+R, O 上,使用右侧列中的选择器,并为您想要禁用的检查选择 不显示。
在此选项页面上,您还可以更改每个代码语法样式规则的首选项。
在 ReSharper 选项 的 页面 Alt+R, O 上,在 组中找到代码语法样式检查,并清除您想要禁用的检查旁边的复选框。
通过代码清理应用代码语法样式
要在所需范围内应用代码语法样式,您还可以使用 代码清理。 您可以使用内置配置文件之一 完全清理或 重新格式化并应用语法样式运行 代码清理 ,或者创建并运行 自定义配置文件 ,其中包含您所需的代码语法样式规则子集。
在 C# 和 C++ 中的代码语法样式的其他操作
在 C# 中,ReSharper 提供了一个专用操作 Control+Alt+S ( )用于应用您的代码语法样式。
将 C# 代码语法样式应用于现有代码
选择您希望应用语法样式首选项的范围:
在编辑器中选择一段内容以在选定内容中应用语法样式首选项。
将光标放置在文件中的任意位置以在文件中应用语法样式首选项。
在 解决方案资源管理器 中选择一个或多个项目,以在这些项目及其子项目下的文件中应用语法样式首选项。
按 Control+Alt+S 或从主菜单中选择 。 或者,您可以按 Control+Shift+A ,在弹出窗口中开始输入命令名称,然后在那里选择它。
您还可以使用相应的上下文操作在当前选定内容中应用代码语法样式。
在当前选区中应用代码语法样式
在编辑器中,选择您希望应用代码语法样式的代码块。
按 Alt+Enter 并选择 。
在不同语言中的适用性
ReSharper 的大多数代码语法样式功能在 C# 和 Visual Basic 中可用,有些功能在多种语言中可用,其他功能则是特定于语言的。 下表列出了所有代码语法样式功能及其支持的语言/技术。
本节中的主题提供了在 C# 中使用代码语法样式功能的说明和示例。 有关特定语言可用的代码语法样式功能的更多信息,请参阅 语言和框架 部分中的相应主题。