代码语法样式：隐式/显式类型（'var' 关键字）

使用隐式类型的局部变量（也称为 var 关键字）在 C# 3.0 中引入后变得非常流行，因为它在许多场景中提高了可读性。默认情况下，ReSharper 也鼓励使用 var 关键字，但其使用偏好是灵活可配置的——例如，您可以选择在特定情况下或所有情况下使用显式类型，ReSharper 将帮助您强制执行您的偏好。

从 C# 7.0 开始，您可以在解构元组时声明局部变量。如果您更喜欢在此类声明中使用 var ，您还可以配置样式以使用合并或分离的表示法，例如： var (x, y) = GetTuple(); 或 (var x, var y) = GetTuple();。

另一个 C# 7.0 功能是丢弃，它还允许使用 var 以确保与作用域中可能命名为 _ 的变量没有冲突。 ReSharper 允许您配置样式以在适当的情况下始终与丢弃一起使用 var。

强制执行使用 'var' 关键字的偏好设置

ReSharper 检查所有局部变量是否符合您的偏好设置，如果它们不符合，ReSharper 会高亮显示此类声明，并建议相应的快速修复或范围修复。

默认情况下，ReSharper 的偏好设置表明更倾向于使用 'var' 关键字：

如果您更改了偏好设置，ReSharper 将帮助您使用显式类型：

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

使用自定义代码清理配置文件应用 'var' 关键字的偏好设置

从主菜单中选择 ReSharper | 选项或按 Alt+R O。
转到代码清理配置文件设置页面：代码编辑 | 代码清理 | 配置文件。
按照创建新的自定义清理配置文件部分的描述创建一个新配置文件。在新配置文件的选定的配置文件设置部分中，勾选强制使用 'var' 关键字的设置复选框。可选地，您可以在此配置文件中启用其他代码清理任务。
单击选项对话框中的保存应用修改，让 ReSharper 选择保存位置，或者通过从保存到选择器中选择特定的设置层来保存修改。有关更多信息，请参见管理和共享 resharper 设置。
选择要强制执行偏好的范围：
- 将光标放置在文件中的任意位置，以对该文件强制执行您的偏好。
- 在解决方案资源管理器中选择一个或多个项目，以对这些节点及其子项下的文件强制执行您的偏好。
执行以下操作之一：
- 按 Control+Alt+F 或从主菜单中选择 ReSharper | 编辑| 清理代码…。
- 右键单击文本编辑器中的任意位置或右键单击选定内容，然后在上下文菜单中选择清理代码。
在打开的代码清理对话框中，选择新创建的配置文件。
单击运行。 ReSharper 将在选定范围内强制执行您的偏好。

如果您希望在不打开代码清理对话框选择配置文件的情况下强制执行 'var' 关键字使用偏好设置，可以将创建的配置文件绑定到静默清理，并通过按 Control+Shift+Alt+F 运行它。您还可以创建一个自定义清理配置文件，将偏好设置的应用与其他代码样式任务结合起来。

要将 'var' 关键字使用偏好设置与所有其他格式化和语法样式规则一起应用于选定的代码块，请 Alt+Enter 并选择重新格式化并清理 | 重新格式化&应用语法样式。

您可以在每次保存文件更改时强制执行 'var' 关键字使用偏好设置，以确保您的编辑始终符合代码样式。

在保存更改时自动强制执行 'var' 关键字使用的偏好设置

从主菜单中选择 ReSharper | 选项或按 Alt+R O。
转到代码清理配置文件设置页面：代码编辑 | 代码清理 | 配置文件。
选择您的自定义代码清理配置文件并单击设为默认（默认配置文件也用于静默清理）。
转到代码编辑 | 代码清理 | 常规选项页面并选择保存文件时自动运行清理。
可选地，您可以通过文件掩码限制自动清理到特定文件。
您还可以选择仅更改的文件部分，以确保清理仅应用于受更改影响的代码，而文件中的其余代码不会被修改。
如果您选择仅清理文件的更改部分，可以通过以下选项微调此行为：
- 如果无法执行部分清理，则执行完全清理 — 根据此选项，ReSharper 将清理整个文件，或者如果无法将清理限制为文件的修改部分，则跳过该文件。
- 允许在保存共享文件时进行清理 — 使用此选项启用或禁用对多次包含在解决方案中的文件（例如共享项目中的文件）的部分清理。
在对话框中单击保存以应用修改，并让 ReSharper 选择保存位置，或者通过从保存到选择器中选择特定的设置层来保存修改。有关更多信息，请参见管理和共享 resharper 设置。
下次您完成编辑并保存文件（Ctrl+S ）或所有文件（Ctrl+Shift+S ）时，ReSharper 将使用选定的配置文件清理受影响的文件。如果未选择默认清理配置文件，ReSharper 将提示您选择一个配置文件。

配置使用 'var' 关键字的偏好设置

您的 'var' 关键字使用偏好设置是通过基于层的设置机制保存的。除此之外，该机制还允许您为不同的解决方案维护不同的偏好，并将这些偏好保存在 VCS 中，自动与团队成员共享。

在选项对话框中配置使用 'var' 关键字的偏好设置

转到 ReSharper 选项的代码编辑 | C# | 语法样式页面 Alt+R, O。
根据您的编码实践/标准修改声明中的 'var' 用法类别中的设置。
您可以为不同类型设置使用 'var' 或显式类型的不同偏好设置：
- 对于内置类型 — 适用于 C# 内置类型。
- 对于简单类型 — 适用于没有泛型参数的类型。
- 其他位置 — 适用于泛型类型和解构声明。
对于这些偏好设置中的每一个，您可以选择使用 'var'、显式类型或显而易见时使用 'var'。
如果您在上一步中选择了在明显时使用 'var' ，您可以选择应用 Visual Studio 逻辑来决定哪些情况应被视为显而易见。
要了解 ReSharper 和 Visual Studio 逻辑之间的差异，请参见在显而易见时使用 'var'：什么被认为是显而易见的？。
默认情况下，ReSharper 会建议在解构声明中对多个 var 使用合并表示法，例如 var (x, y) = GetTuple();。您可以选择为析构变量首选单独的声明以选择分离表示法，例如 (var x, var y) = GetTuple();。
默认情况下，ReSharper 建议对丢弃使用独立的 _ ，例如 (_, _) = (0, 1);。您可以选择将 'var' 关键字用于弃元以始终在适当的情况下与丢弃一起使用 var ，从而确保与作用域中可能命名为 _ 的变量没有冲突。
右侧列中的通知方式选择器允许您设置严重性级别，以检测与您的偏好不一致的代码检查。
单击选项对话框中的保存应用修改，让 ReSharper 选择保存位置，或者通过从保存到选择器中选择特定的设置层来保存修改。有关更多信息，请参见管理和共享 resharper 设置。

您还可以直接在编辑器中更改使用 'var' 关键字的偏好设置，其中相应的问题已被高亮显示：

从编辑器更改使用 'var' 关键字的偏好设置

将光标放置在一个 ReSharper 检查高亮显示的代码问题上。
按 Alt+Enter 或单击光标左侧的操作指示器以打开操作列表。
在操作列表中，转到检查 "使用首选的 'var' 样式" | 配置代码样式，然后选择所需的偏好设置：
。
您的更改将使用智能保存逻辑保存。
如果您需要将修改后的样式偏好保存到共享设置层，请单击配置代码样式菜单项或在选中时按 输入。 ReSharper 将打开 ReSharper 选项的代码编辑 | C# | 语法样式页面，您可以根据需要修改您的偏好，单击保存到，然后选择所需的设置层。

在显而易见时使用 'var'：什么被认为是显而易见的？

在配置 'var' 关键字与显式类型的使用偏好时，您可以选择在明显时使用 'var'。此选项看起来不言自明，但在某些情况下可能不清楚什么被认为是“显而易见的”，什么不是。

除此之外，ReSharper 和 Visual Studio 在建议使用 'var' 关键字或显式类型时，对“显而易见”的定义也存在一些差异。

The table below shows in which cases initializers that could be declared 'var' are considered evident depending on the state of the 为类型证据首选 Roslyn (Visual Studio)逻辑 checkbox on the 代码编辑 | C# | 语法样式 page of ReSharper 选项 Alt+R, O.

初始化表达式	示例	关闭	开启
对象创建表达式	`new MyClass()`	显而易见	显而易见
类型转换表达式	`(MyClass) obj`	显而易见	显而易见
`as` 表达式	`obj as MyClass`	显而易见	显而易见
文字表达式	`"some string literal"` `123` `true`	显而易见	显而易见
默认表达式	`default(MyClass)`	显而易见	显而易见
元组表达式	`(1, 2, 3)`	当所有组件表达式都显而易见时显而易见
显式数组创建表达式	`new int[] { 1, 2, 3 }` `new MyClass[5]`	显而易见	显而易见
隐式数组创建表达式	`new [] { 1, 2, 3}` `new [,] { {1, 2, 3}, {1, 2, 3}, {1, 2, 3} }`	当所有元素初始化器（最多 42 个）显而易见时显而易见	不显而易见
非泛型工厂（创建）方法（在某种类型中声明的静态方法并返回相同类型的值）	`MyClass.Build(someArgs) // 返回 MyClass`	当方法名称包含父类型名称或以下子字符串之一时显而易见："Create"、"Build"、"Construct"、"Make"、"Generate"、"Produce"、"New"、"Instance"	显而易见
泛型工厂（创建）方法（返回泛型类型并在与返回类型同名的类中声明的静态方法）	`Tuple.Create(1, 2, 3)`	当所有方法调用参数显而易见且方法名称包含以下子字符串之一或类名时显而易见："Create"、"Build"、"Construct"、"Make"、"Generate"、"Produce"、"New"、"Instance"	显而易见
转换方法（名称由 "To" 加上返回类型名称组成的方法）	`obj.ToString()enumeration.ToList()`	当返回类型不是泛型时显而易见	显而易见
具有显式类型参数并返回该类型参数值的泛型方法	`obj.GetValue<MyClass>() // 返回 MyClass`	显而易见	不显而易见
枚举成员	`KnownColor.Azure`	显而易见	不显而易见
单例字段（静态/常量字段返回其声明类型的值）	`int.MaxValuestring.Empty`	当字段名称包含类型名称或以下子字符串之一时显而易见："Empty"、"Instance"、"Default"、"Value"	不显而易见

在不同语言中的适用性

此功能在以下语言和技术中受支持：

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

最后修改日期： 2025年 9月 27日