代码样式规则

.NET代码样式分析提供的规则旨在维护代码库中的一致 style。 这些规则的规则 ID 具有“IDE”前缀。

代码样式规则组织为以下子类别：

• 语言和不必要的代码规则

  与 C# 或Visual Basic语言相关的规则。 例如，您可以指定在定义变量时有关使用 var 的规则，或者有关是否首选表达式主体成员的规则。 此类别还包括查找不必要的代码的规则，例如，方法中无法访问的代码或未使用的私有字段、属性或方法。

• 格式设置规则

  与代码的布局和结构有关的规则，其作用是使代码更易于阅读。 例如，可以指定格式设置选项来定义是否首选控制块中的空格。

• 命名规则

  与代码元素命名相关的规则。 例如，可以指定 async 方法名必须具有“Async”后缀。

• 其他规则

  不属于其他类别的规则。

索引

下表按 ID 和 选项列出所有代码样式规则（如果有）。

规则 ID	标题	选项
IDE0001	简化名称
IDE0002	简化成员访问
IDE0003	名称可以简化	dotnet_style_qualification_for_field dotnet_style_qualification_for_property dotnet_style_qualification_for_method dotnet_style_qualification_for_event
IDE0004	删除不必要的 cast
IDE0005	删除不必要的 import
IDE0007	用 var 替代显式类型	csharp_style_var_for_built_in_types csharp_style_var_when_type_is_apparent csharp_style_var_elsewhere
IDE0008	用显式类型代替 var	csharp_style_var_for_built_in_types csharp_style_var_when_type_is_apparent csharp_style_var_elsewhere
IDE0009	成员访问权限应限定	dotnet_style_qualification_for_field dotnet_style_qualification_for_property dotnet_style_qualification_for_method dotnet_style_qualification_for_event
IDE0010	将缺失的事例添加到 switch 语句
IDE0011	添加大括号	csharp_prefer_braces
IDE0016	使用 throw 表达式	csharp_style_throw_expression
IDE0017	使用对象初始值设定项	dotnet风格的对象初始化器
IDE0018	内联变量声明	csharp_style_inlined_variable_declaration
IDE0019	使用模式匹配来避免 as 后跟 null 检查	csharp_style_pattern_matching_over_as_with_null_check
IDE0020	使用模式匹配来避免后跟强制转换的 is 检查（带变量）	csharp_style_pattern_matching_over_is_with_cast_check
IDE0021	使用表达式主体来定义构造函数	csharp_style_expression_bodied_constructors
IDE0022	使用方法的表达式主体	csharp_style_expression_bodied_methods
IDE0023	使用转换运算符的表达式主体	csharp_style_expression_bodied_operators
IDE0024	使用运算符时使用表达式体	csharp_style_expression_bodied_operators
IDE0025	使用属性的表达式主体	csharp_style_expression_bodied_properties
IDE0026	使用索引器的表达式主体	csharp_style_expression_bodied_indexers
IDE0027	为访问器使用表达式主体	csharp_style_expression_bodied_accessors
IDE0028	使用集合初始值设定项	dotnet_style_collection_initializer dotnet_style_prefer_collection_expression
IDE0029	可以简化 Null 检查	dotnet_style_coalesce_expression
IDE0030	可以简化 Null 检查	dotnet_style_coalesce_expression
IDE0031	使用空值传播	dotnet_style_null_propagation
IDE0032	使用自动属性	dotnet_style_prefer_auto_properties
IDE0033	使用明确提供的元组名称	dotnet_style_explicit_tuple_names
IDE0034	简化 default 表达式	csharp_优先使用简单默认表达式
IDE0035	删除无法访问的代码
IDE0036	对修饰符进行排序	csharp_preferred_modifier_order visual_basic_preferred_modifier_order
IDE0037	使用推断的成员名称	dotnet_style_prefer_inferred_tuple_names dotnet_style_prefer_inferred_anonymous_type_member_names
IDE0038	使用模式匹配来避免后跟强制转换的 is 检查（不带变量）	csharp_style_pattern_matching_over_is_with_cast_check
IDE0039	使用本地函数而不是 Lambda	csharp_style_prefer_local_over_anonymous_function
IDE0040	添加可访问性修饰符	dotnet_style_require_accessibility_modifiers
IDE0041	使用 is null 检查	dotnet_style_prefer_is_null_check_over_reference_equality_method
IDE0042	解构变量声明	csharp_style_deconstructed_variable_declaration
IDE0044	添加 readonly 修饰符	dotnet_style_readonly_field
IDE0045	使用条件表达式进行赋值	dotnet_style_prefer_conditional_expression_over_assignment
IDE0046	使用条件表达式返回	dotnet_style_prefer_conditional_expression_over_return
IDE0047	删除不必要的括号	dotnet_style_parentheses_in_arithmetic_binary_operators dotnet_style_parentheses_in_relational_binary_operators dotnet_style_parentheses_in_other_binary_operators dotnet_style_parentheses_in_other_operators
IDE0048	为清楚起见，请添加括号	dotnet_style_parentheses_in_arithmetic_binary_operators dotnet_style_parentheses_in_relational_binary_operators dotnet_style_parentheses_in_other_binary_operators dotnet_style_parentheses_in_other_operators
IDE0049	使用语言关键字，而不是框架的类型名称用于类型引用	dotnet_style_predefined_type_for_locals_parameters_members dotnet_style_predefined_type_for_member_access
IDE0050	将匿名类型转换为元组
IDE0051	删除未使用的私有成员
IDE0052	删除未读取的私有变量
IDE0053	使用 Lambda 的表达式主体	csharp_style_expression_bodied_lambdas
IDE0054	使用复合赋值	dotnet_style_prefer_compound_assignment
IDE0055	修正格式	（太多无法在此处列出。请参阅 .NET 格式设置选项和 C# 格式选项.）
IDE0056	使用索引运算符	csharp_style_prefer_index_operator
IDE0057	使用范围运算符	csharp_style_prefer_range_operator
IDE0058	删除未使用的表达式值	csharp_style_unused_value_expression_statement_preference visual_basic_style_unused_value_expression_statement_preference
IDE0059	删除不必要的赋值	csharp_style_unused_value_assignment_preference visual_basic_style_unused_value_assignment_preference
IDE0060	删除未使用的参数	dotnet_code_quality_unused_parameters
IDE0061	为局部函数使用表达式主体	csharp_style_expression_bodied_local_functions
IDE0062	生成本地函数 static	csharp_prefer_static_local_function
IDE0063	使用简单的 using 语句	csharp_prefer_simple_using_statement
IDE0064	将结构字段设置为可写
IDE0065	using 指令放置	csharp_using_directive_placement
IDE0066	使用 switch 表达式	csharp_style_prefer_switch_expression
IDE0070	使用 System.HashCode.Combine	dotnet_prefer_system_hash_code
IDE0071	简化内插	dotnet_style_prefer_simplified_interpolation
IDE0072	将缺失的情况添加到 switch 表达式中
IDE0073	使用文件头	文件头模板
IDE0074	使用联合复合赋值	dotnet_style_prefer_compound_assignment
IDE0075	简化条件表达式	dotnet_style_prefer_simplified_boolean_expressions
IDE0076	删除无效的全局 SuppressMessageAttribute
IDE0077	避免在全局 SuppressMessageAttribute 中使用旧格式目标
IDE0078	使用模式匹配	csharp_style_prefer_pattern_matching
IDE0079	删除不必要的抑制	dotnet_remove_unnecessary_suppression_exclusions
IDE0080	删除不必要的抑制运算符
IDE0081	删除 ByVal
IDE0082	将 typeof 转换为 nameof
IDE0083	使用模式匹配（not 运算符）	CSharp 样式偏好非模式
IDE0084	使用模式匹配（IsNot 运算符）	visual_basic_style_prefer_isnot_expression
IDE0090	简化 new 表达式	csharp_style_implicit_object_creation_when_type_is_apparent
IDE0100	删除不必要的相等运算符
IDE0110	删除不必要的弃物
IDE0120	简化 LINQ 表达式
IDE0121	简化 LINQ 类型检查和强制转换
IDE0130	命名空间与文件夹结构不匹配	dotnet_style_namespace_match_folder
IDE0140	简化对象的创建	Visual Basic 风格偏好简化对象创建
IDE0150	更倾向于 null 检查，而非类型检查。	csharp_style_prefer_null_check_over_type_check
IDE0160	使用以程序块为作用域的命名空间	csharp_style_namespace_declarations
IDE0161	使用以文件为作用域的命名空间	csharp_style_namespace_declarations
IDE0170	简化属性模式	csharp_style_prefer_extended_property_pattern
IDE0180	使用元组来交换值	csharp_style_prefer_tuple_swap
IDE0200	删除不必要的 Lambda 表达式	csharp_style_prefer_method_group_conversion
IDE0210	转换为顶级语句	csharp_style_prefer_top_level_statements
IDE0211	转换为“Program.Main”样式程序	csharp_style_prefer_top_level_statements
IDE0220	在 foreach 循环中添加显式强制转换	dotnet_style_prefer_foreach_explicit_cast_in_source
IDE0221	添加显式强制转换	dotnet_style_prefer_non_hidden_explicit_cast_in_source
IDE0230	使用 UTF-8 字符串字面量	csharp_style_prefer_utf8_string_literals
IDE0240	Nullable 指令是冗余的
IDE0241	Nullable 指令是不必要的
IDE0250	可以将结构设为“只读”	csharp_style_prefer_readonly_struct
IDE0251	成员可设为“只读”	csharp_style_prefer_readonly_struct_member
IDE0260	使用模式匹配	csharp_style_pattern_matching_over_as_with_null_check
IDE0270	可以简化 Null 检查	dotnet_style_coalesce_expression
IDE0280	使用 nameof
IDE0290	使用主构造函数	csharp_style_prefer_primary_constructors
IDE0300	使用数组的集合表达式	dotnet_style_prefer_collection_expression
IDE0301	使用集合表达式来表示空的状态	dotnet_style_prefer_collection_expression
IDE0302	使用 stackalloc 的集合表达式	dotnet_style_prefer_collection_expression
IDE0303	使用 Create() 的集合表达式	dotnet_style_prefer_collection_expression
IDE0304	使用构建器的集合表达式	dotnet_style_prefer_collection_expression
IDE0305	使用 fluent 的集合表达式	dotnet_style_prefer_collection_expression
IDE0306	将集合表达式用于新的对象	dotnet_style_prefer_collection_expression
IDE0320	生成匿名函数 static	csharp_prefer_static_anonymous_function
IDE0330	首选“System.Threading.Lock”	csharp_prefer_system_threading_lock
IDE0340	使用未绑定泛型类型	csharp_style_prefer_unbound_generic_type_in_nameof
IDE0350	使用隐式类型 Lambda 表达式	csharp_style_prefer_implicitly_typed_lambda_expression
IDE0360	简化属性访问器	csharp_style_prefer_simple_property_accessors
IDE0370	删除不必要的抑制
IDE0380	删除不必要的“不安全”修饰符
IDE1005	使用条件委托调用	csharp_style_conditional_delegate_call
IDE1006	命名样式
IDE2000	避免多个空白行	dotnet_style_allow_multiple_blank_lines_experimental†
IDE2001	嵌入语句必须单独占一行。	csharp_style_allow_embedded_statements_on_same_line_experimental†
IDE2002	连续大括号之间不得有空行	csharp_style_allow_blank_lines_between_consecutive_braces_experimental†
IDE2003	块和后续语句之间所需的空白行	dotnet_style_allow_statement_immediately_after_block_experimental†
IDE2004	不允许在构造函数初始化冒号后添加空行	csharp_style_allow_blank_line_after_colon_in_constructor_initializer_experimental†
IDE2005	条件表达式标记后不允许使用空行	csharp_style_allow_blank_line_after_token_in_conditional_expression_experimental†
IDE2006	箭头表达式子句标记后不允许使用空行	csharp_style_allow_blank_line_after_token_in_arrow_expression_clause_experimental†
IDE3000	使用 Copilot 实现

†这些规则是实验性的，可能会更改或删除。

注意

有一些规则仅在Visual Studio IDE中浮出水面，这些规则涉及 JSON 和正则表达式模式字符串。 有关详细信息，请参阅 JSON001、 JSON002和 RE0001。

图例

下表显示了参考文档中每个规则提供的信息类型。

项	说明
规则 ID	规则的唯一标识符。 用于在代码文件中配置规则严重性并禁止显示警告。
标题	规则的标题。
类别	规则的类别。
子类别	规则的子类别，例如语言规则、格式规则或命名规则。
适用的语言	适用的.NET语言（C# 或 Visual Basic），以及最低语言版本（如果适用）。
引入的版本	首次引入该规则时的 .NET SDK 或 Visual Studio 的版本。
选项	规则的任何可用选项。

另请参阅

• 在生成时强制执行代码样式
• Visual Studio 中的快速操作
• 在 Visual Studio