JetBrains Rider 2025.2 Help

CSS 中的代码检查

本主题列出了 CSS 中所有可用的 JetBrains Rider 代码检查

您可以在 编辑器 | 检查设置 | 检查严重性 | 其他语言 设置页面  Ctrl+Alt+S 上切换特定检查或更改其严重性级别。

可能的 bug

检查

描述

默认严重性

选择器列表中缺少逗号

报告多行选择器。 这很可能意味着实际上是想要多个单行选择器,但某一行或几行的末尾缺少逗号。

示例:

input /* comma has probably been forgotten */ .button { margin: 1px; }

警告 警告

缺少通用字体族名称

验证 字体系列 属性是否包含通用字体族名称作为备用选项。

通用字体族名称包括: 衬线无衬线手写体幻想体等宽字体

警告 警告

像素值中非整数长度

报告像素值中非整数的长度。

示例:

width: 3.14px

弱警告 弱警告

代码质量工具

检查

描述

默认严重性

Stylelint

报告由 Stylelint linter 检测到的不一致性。

突出显示基于每个规则在 Stylelint 配置文件中指定的规则严重性。

已禁用

W3C CSS 验证器

报告由 W3C CSS 验证器检测到的不一致性。

已禁用

代码样式问题

检查

描述

默认严重性

缺少分号

报告声明末尾缺少分号。

已禁用

冗余的度量单位

报告零值的度量单位,而规范不要求使用单位。

示例:

width: 0px

警告 警告

无效元素

检查

描述

默认严重性

无效函数

报告未知的 CSS 函数或不正确的函数参数。

错误 错误

无效媒体特性

报告未知的 CSS 媒体特性或不正确的媒体特性值。

错误 错误

无效属性值

报告不正确的 CSS 属性值。

错误 错误

无效伪选择器

报告不正确的 CSS 伪类 伪元素

错误 错误

无效类型选择器

报告匹配未知 HTML 元素的 CSS 类型选择器

警告 警告

@import 位置错误

报告 @import 语句位置错误。

根据 规范@import 规则必须位于所有其他类型规则之前,除了 @字符集 规则。

警告 警告

@charset 位置错误或不正确

报告 @字符集 at-rule 位置错误或 charset 值不正确。

警告 警告

负属性值

报告不应小于零的 CSS 属性的负值,例如对象宽度或高度。

错误 错误

未知 at-rule

报告未知的 CSS at-rule

错误 错误

未知属性

报告未知的 CSS 属性或在错误上下文中使用的属性。

将未知属性添加到“自定义 CSS 属性”列表以跳过验证。

警告 警告

在 'composes' 规则中未解析的类

报告在 'composes'规则中无法解析为任何有效目标的 CSS 类引用。

示例:

.className {/* ... */} .otherClassName { composes: className; }

错误 错误

未解析的自定义属性

报告在 var() 函数的参数中对 自定义属性的未解析引用。

错误 错误

未解析的文件引用

报告未解析的文件引用,例如 @import 语句中的路径不正确。

错误 错误

其他检查

检查

描述

默认严重性

颜色可以替换为 #-hex

报告 rgb()hsl() 或其他颜色函数。

建议将颜色函数替换为等效的十六进制表示法。

示例:

rgb(12, 15, 255)

应用快速修复后:

#0c0fff

.

已禁用

颜色可以替换为 rgb()

报告 hsl()hwb() 颜色函数或十六进制颜色表示法。

建议将此类颜色值替换为等效的 rgb()rgba() 颜色函数。

示例:

#0c0fff

应用快速修复后:

rgb(12, 15, 255)

.

已禁用

被覆盖的属性

报告规则集中重复的 CSS 属性。 支持简写属性。

示例:

.foo { margin-bottom: 1px; margin-bottom: 1px; /* duplicates margin-bottom */ margin: 0; /* overrides margin-bottom */ }

警告 警告

属性可以安全地替换为简写

报告一组长格式属性。 建议将完整的一组长格式 CSS 属性替换为等效的简写形式。

例如,4 个属性: padding-toppadding-rightpadding-bottompadding-left 可以安全地替换为单个 填充 属性。

请注意,如果长格式属性集不完整(例如规则集中只有 3 个 padding-xxx 属性),此检查不会显示,因为切换到简写可能会更改结果。 对于此类情况,请考虑“属性可能可以替换为简写”检查。

弱警告 弱警告

属性可能可以替换为简写

报告一组长格式 CSS 属性,并建议将不完整的长格式 CSS 属性集替换为简写形式,但在这种情况下并非 100% 等效。

例如,2 个属性: outline-coloroutline-style 可以替换为单个 边框。 此类替换并非 100% 等效,因为简写会将所有省略的子值重置为其初始状态。 在此示例中,切换到 边框 简写意味着 outline-width 也将设置为其初始值,即

此检查不处理完整的长格式属性集(当切换到简写 100% 安全时)。 对于此类情况,请参阅“属性可以安全地替换为简写”检查。

信息 无高亮,仅修复

属性与选定浏览器不兼容

报告指定浏览器不支持的 CSS 属性。 基于 MDN 兼容性数据

已禁用

未使用的选择器

报告出现在选择器中但未在 HTML 中使用的 CSS 类或元素 ID。

请注意,完整的检查结果仅在通过 Code | Inspect Code 或 Code | Analyze Code | Run Inspection by Name 运行时可用。 由于性能原因,样式表文件不会实时检查。

警告 警告

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