XAML 中的代码检查

在 XAML 中，JetBrains Rider 2025.2 提供了两种代码检查：4 项检测错误的检查，例如语法错误、未解析的符号、编译器错误等（这些检查无法配置或禁用），以及 76 项专有代码检查，您可以禁用或更改其严重性级别。
这些代码检查帮助您在所有打开的文件中设计时检测代码问题，并且还允许您在特定范围内查找代码问题。

可配置的 XAML 检查列在下方，并按其类别分组。

代码通知（26 项检查）

此类别包含轻微严重性级别的代码检查。

检查 ID EditorConfig 属性	默认严重性
{DynamicResource} 只能与依赖属性一起使用 `XAML 动态资源错误` `XAML 动态资源错误高亮显示`	错误
构造函数未解析 `Xaml.构造函数警告` `resharper_xaml_constructor_warning_highlighting`	警告
十进制数字的解析取决于当前机器的区域设置 `Xaml.小数解析受区域性影响` `resharper_xaml_decimal_parsing_is_culture_dependent_highlighting`	警告
缺少依赖属性描述符字段 `Xaml.依赖属性解析错误` `resharper_xaml_dependency_property_resolve_error_highlighting`	警告
元素名称引用未解析 `Xaml.ElementName 引用无法解析` `resharper_xaml_element_name_reference_not_resolved_highlighting`	错误
网格列/行定义可以转换为属性 `XAML 网格定义可以转换为属性` `XAML 网格定义可以转换为属性高亮显示`	提示
网格长度定义不能为空 `XAML 空网格长度定义` `XAML 空网格长度定义高亮显示`	错误
忽略的路径 `XAML 被忽略路径高亮显示` `XAML 被忽略路径高亮显示`	已禁用
映射的路径 `XAML 映射路径高亮显示` `XAML 映射路径高亮显示`	提示
无效类型的成员 `XAML 成员类型无效` `XAML 成员类型无效高亮显示`	错误
方法参数将在生成的代码中被事件的参数替换 `XAML 方法参数将被忽略` `XAML 方法参数将被忽略高亮显示`	警告
找到具有相同参数数量的多个重载 `XAML 重载冲突` `XAML 重载冲突高亮显示`	警告
无效类型的对象/标记扩展 `XAML 类型无效` `XAML 类型无效高亮显示`	错误
父级在当前组件树之外 `XAML 父级超出当前组件树` `XAML 父级超出当前组件树的高亮显示`	警告
资源路径区分大小写 `XAML 资源文件路径大小写不匹配` `XAML 资源文件路径大小写不匹配高亮显示`	警告
缺少路由事件描述符字段 `XAML 路由事件解析错误` `XAML 路由事件解析错误高亮显示`	警告
未解析的静态资源 `XAML 静态资源未解析` `XAML 静态资源未解析高亮显示`	警告
未找到样式类 `XAML 未找到样式类` `XAML 样式类未找到高亮显示`	警告
当 DataContext 已知时，绑定路径未解析 `XAML 带上下文的绑定未解析` `XAML 带上下文的绑定未解析高亮显示`	警告
当 DataContext 未知时，绑定路径未解析 `XAML 无上下文的绑定未解析` `XAML 无上下文的绑定未解析高亮显示`	提示
在 TwoWay 或 OneWayToSource 绑定模式中使用流绑定运算符 `XAML Avalonia 流绑定操作符的绑定模式错误` `XAML Avalonia 流绑定操作符的绑定模式错误高亮显示`	警告
未为 CompiledBinding 指定 x:DataType `XAML 编译绑定缺少数据类型错误高亮显示` `XAML 编译绑定缺少数据类型错误高亮显示`	错误
x:FieldModifier 属性需要 x:Name 属性 `XAML 字段修饰符需要 Name 属性` `XAML 字段修饰符需要 Name 属性的高亮显示`	警告
无效类型的 XAML 动态资源 `XAML 动态资源类型无效` `XAML 动态资源类型无效高亮显示`	建议
无效类型的 XAML 资源 `XAML 资源类型无效` `XAML 资源类型无效高亮显示`	错误
无效目标类型的 XAML 样式 `XAML 资源目标类型无效` `XAML 资源目标类型无效高亮显示`	错误

常见实践和代码改进（3 项检查）

此类别包含主要影响代码可读性的中等严重性问题的检查。

检查 ID EditorConfig 属性	默认严重性
成员可以设为私有（非私有访问权限） `成员可以为 private（全局）` `成员可以为 private（全局）高亮显示`	建议
成员可以设为受保护（非私有访问权限） `成员可以为 protected（全局）` `成员可以为 protected（全局）高亮显示`	建议
成员或类型可以设为内部（友元） `成员可以为 internal` `成员可以为 internal 高亮显示`	已禁用

编译器警告（2 项检查）

此类别中的检查可在编译前检测到编译器警告。

检查 ID EditorConfig 属性	默认严重性
使用了已过时的类型或类型成员 `已废弃元素` `已废弃元素高亮显示`	警告
使用了已过时的类型或类型成员（错误） `已废弃元素错误` `已废弃元素错误高亮显示`	错误

约束违规（2 项检查）

此类别包括代码检查，主要具有警告严重性级别，检测与符号属性相关的违规，包括 JetBrains Rider 的代码注解和其他类似问题。

检查 ID EditorConfig 属性	默认严重性
命名不一致 `命名不一致` `命名不一致高亮显示`	警告
可能将 'null' 分配给不可为空的实体 `XAML 将 null 赋值给 NotNull 属性` `XAML 将 null 赋值给 NotNull 属性高亮显示`	警告

语法问题（4 项检查）

此类别中的检查报告字符串字面量和文档注释中的语法问题。

检查 ID EditorConfig 属性	默认严重性
注释中的语法错误 `注释中语法错误` `注释中语法错误高亮显示`	建议
标记属性值中的语法错误 `标记属性中的语法错误` `标记属性中的语法错误高亮显示`	建议
标记文本中的语法错误 `标记文本中的语法错误` `标记文本中的语法错误高亮显示`	建议
字符串文字中的语法错误 `字符串文字中的语法错误` `字符串文字中的语法错误高亮显示`	已禁用

潜在的代码质量问题（18 项检查）

此类别包括检测关键问题（代码异味）的检查，主要为错误或警告级别。此类别还包括确保本地化支持的检查。

检查 ID EditorConfig 属性	默认严重性
特定于 DeviceFamily 的视图类型名称与通用类型名称不匹配 `XAML 设备系列视图 CLR 名称不匹配高亮显示` `XAML 设备系列视图 CLR 名称不匹配高亮显示`	警告
重复的 DeviceFamily 视图 `XAML 重复的设备系列类型视图高亮显示` `XAML 重复的设备系列类型视图高亮显示`	错误
重复的样式属性/事件设置器 `XAML 重复的样式 Setter` `XAML 重复的样式 Setter 高亮显示`	警告
网格元素列/行索引超出网格定义范围 `XAML 网格定义索引超出范围` `XAML 网格定义索引超出范围高亮显示`	警告
非第一个子项缺少网格列/行设置器 `XAML 缺少网格索引` `XAML 缺少网格索引高亮显示`	警告
未访问的字段（非私有访问权限） `字段未访问（全局）` `字段未访问（全局）高亮显示`	建议
未访问的字段（私有访问权限） `字段未访问（局部）` `字段未访问（局部）高亮显示`	警告
路径错误 `XAML 路径错误` `XAML 路径错误高亮显示`	警告
绑定路径中可能存在 'null' 值且没有回退值 `XAML 潜在的空引用异常` `XAML 潜在的空引用异常高亮显示`	建议
未显式设置 RelativeSourceMode `XAML RelativeSource 默认模式警告高亮显示` `XAML RelativeSource 默认模式警告高亮显示`	警告
由于 x:Key 属性，资源无法通过类名访问 `XAML 多余的 Xamarin.Forms 类声明` `XAML 多余的 Xamarin.Forms 类声明高亮显示`	警告
样式目标类型无法转换为基类型 `XAML 样式目标类型无效` `XAML 样式目标类型无效高亮显示`	错误
x:DataType 和 BindingContext 中的类型不匹配 `XAML Xamarin.Forms 的 DataType 与 BindingContext 类型不匹配高亮显示` `XAML Xamarin.Forms 的 DataType 与 BindingContext 类型不匹配高亮显示`	警告
意外的元素错误 `XAML 意外的元素` `resharper_xaml_unexpected_element_highlighting`	错误
意外的文本标记错误 `Xaml.意外的文本标记` `resharper_xaml_unexpected_text_token_highlighting`	错误
未知的 DeviceFamily `Xaml.未知的 DeviceFamily 类型突出显示` `resharper_xaml_xaml_unknown_device_family_type_highlighting_highlighting`	警告
x:Key 仅允许用于资源和字典元素 `Xaml.XKey 属性不允许使用` `resharper_xaml_x_key_attribute_disallowed_highlighting`	错误
XAML 语言级别错误 `Xaml.语言级别` `resharper_xaml_language_level_highlighting`	错误

代码中的冗余（13 项检查）

此类别中的代码检查查找冗余和无用代码，这些代码会影响代码的可读性和样式，可以安全地删除。某些代码冗余无法自动修复，针对这些冗余的快速修复将在交互模式下执行，需要用户输入。但大多数冗余可以在无需用户交互的情况下修复，使用范围内修复或代码清理。

检查 ID EditorConfig 属性	默认严重性
绑定模式等于默认值 `Xaml.冗余的 BindingMode 属性` `resharper_xaml_redundant_binding_mode_attribute_highlighting`	警告
属性值等于样式提供的值 `Xaml.冗余的样式值` `resharper_xaml_redundant_styled_value_highlighting`	警告
冗余的空集合属性设置器 `Xaml.冗余的集合属性` `resharper_xaml_redundant_collection_property_highlighting`	警告
冗余的 'Freeze' 属性 `Xaml.冗余的 Freeze 属性` `resharper_xaml_redundant_freeze_attribute_highlighting`	警告
冗余的修饰符属性 `Xaml.冗余的修饰符属性` `resharper_xaml_redundant_modifiers_attribute_highlighting`	警告
冗余的名称属性 `Xaml.冗余的 Name 属性` `resharper_xaml_redundant_name_attribute_highlighting`	警告
冗余的命名空间别名 `Xaml.冗余的命名空间别名` `resharper_xaml_redundant_namespace_alias_highlighting`	警告
冗余的属性类型限定符 `Xaml.冗余的属性类型限定符` `resharper_xaml_redundant_property_type_qualifier_highlighting`	警告
冗余的资源 `Xaml.冗余的资源` `resharper_xaml_redundant_resource_highlighting`	警告
移除冗余的附加属性设置器 `Xaml.冗余的附加属性` `resharper_xaml_redundant_attached_property_highlighting`	警告
单个网格行/列定义是冗余的 `Xaml.冗余的网格定义` `resharper_xaml_redundant_grid_definitions_highlighting`	警告
单元格网格列/行跨度是冗余的 `Xaml.冗余的网格跨度` `resharper_xaml_redundant_grid_span_highlighting`	警告
UpdateSourceTrigger=Default 是冗余的 `Xaml.冗余的 UpdateSourceTrigger 属性` `resharper_xaml_redundant_update_source_trigger_attribute_highlighting`	警告

符号声明中的冗余（4 项检查）

此类别包括代码检查，主要是警告严重级别，用于检测空的和未使用的符号声明。

检查 ID EditorConfig 属性	默认严重性
类型从未使用（非私有访问权限） `UnusedType.全局` `resharper_unused_type_global_highlighting`	建议
类型从未使用（私有访问权限） `UnusedType.局部` `resharper_unused_type_local_highlighting`	警告
类型成员从未使用（非私有访问权限） `UnusedMember.全局` `resharper_unused_member_global_highlighting`	建议
类型成员从未使用（私有访问权限） `UnusedMember.局部` `resharper_unused_member_local_highlighting`	警告

拼写问题（4 项检查）

这些检查检测各种上下文中的拼写错误。

检查 ID EditorConfig 属性	默认严重性
注释中的拼写错误 `注释拼写错误` `resharper_comment_typo_highlighting`	建议
标识符中的拼写错误 `标识符拼写错误` `resharper_identifier_typo_highlighting`	建议
标记属性值中的拼写错误 `标记属性拼写错误` `resharper_markup_attribute_typo_highlighting`	建议
标记文本中的拼写错误 `标记文本拼写错误` `resharper_markup_text_typo_highlighting`	建议

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