Stylelint 对未知 CSS 语法检查能力的全面增强

在 CSS 代码质量检查工具 Stylelint 的最新发展中，核心团队正在对未知 CSS 语法检查功能进行系统性增强。这一系列改进将显著提升开发者对 CSS 代码中潜在问题的检测能力。

现有检查机制的局限性

当前 Stylelint 在检查未知 CSS 语法时存在三个主要问题：

1. 覆盖范围不完整：某些 CSS 语法结构尚未被现有规则覆盖
2. 规则重叠：多个规则可能同时检查同一语法问题，导致重复报错
3. 作用域不准确：部分规则检查了超出其设计范围的语法结构

这些问题影响了用户体验和检查结果的准确性。

新增规则与功能

为解决上述问题，Stylelint 计划引入以下新规则：

1. at-rule-prelude-no-unknown：专门检查 at 规则前导部分中的未知语法。例如，在 @property foo {} 中识别非法的自定义属性名称。

2. at-rule-descriptor-no-unknown：针对 at 规则描述符的检查。能够发现如 @counter-style bar { margin: 0; } 中不合适的 margin 描述符。

3. at-rule-descriptor-value-no-unknown：验证 at 规则描述符值的合法性。例如检测 @font-face { size-adjust: red; } 中 size-adjust 属性的无效颜色值。

现有规则的优化

除了新增规则外，团队还对现有规则进行了重要调整：

1. 为 string-no-newline 规则新增 ignore 选项，允许开发者灵活控制检查范围。

2. 修正 property-no-unknown 和 declaration-property-value-no-unknown 规则的作用域，使其专注于标准 CSS 属性检查，不再误检 at 规则的描述符。

3. 重构 property-no-unknown 和 at-rule-no-unknown 规则，改用 csstree 提供的数据源，提高检查准确性和一致性。

性能与配置优化

考虑到新增规则可能带来的性能影响，团队正在探索引入类似 ESLint 的 languageOptions 配置方案。这种集中式的语法配置方式有望：

• 减少重复的语法解析开销
• 提供统一的语法自定义接口
• 简化复杂项目的配置管理

对开发者的影响

这些改进将带来以下好处：

1. 更全面的错误检测：几乎覆盖所有 CSS 语法结构的未知值检查。

2. 更精确的错误定位：专门的规则针对特定语法结构，提供更准确的错误信息。

3. 更灵活的配置：新增的忽略选项让开发者能够精细控制检查行为。

4. 更好的性能：通过集中式语法配置减少重复解析。

对于使用 Stylelint 共享配置的用户，这些改进将默认启用，无需额外配置即可获得更完善的代码检查能力。而对于使用预处理语言（如 SCSS）的开发者，仍然可以通过适当的配置选项保持现有检查行为。

这一系列改进标志着 Stylelint 在 CSS 语法检查方面迈出了重要一步，为开发者提供了更强大、更精确的工具来保证样式代码的质量和可靠性。