UnoCSS 中合并相同选择器的 CSS 规则优化实践

在 UnoCSS 使用过程中，开发者 awwwdev 遇到了一个关于 CSS 规则合并的优化问题。当多个规则应用于同一个选择器（如根选择器）时，UnoCSS 默认不会合并这些规则，导致生成的 CSS 文件中出现多个相同选择器的重复定义，这会影响最终的 CSS 文件大小和性能。

问题背景

在项目中，开发者通过自定义规则和快捷方式向根选择器添加 CSS 变量时，发现生成的 CSS 文件中存在多个相同的选择器定义。例如：

.light-mode {
  --color-primary: #000;
}
.light-mode {
  --color-secondary: #fff;
}

理想情况下，这些规则应该被合并为：

.light-mode {
  --color-primary: #000;
  --color-secondary: #fff;
}

解决方案探索

1. 使用预设主题方案

有开发者建议使用 unpreset/unocss-preset-theme 预设，该预设能够自动在根选择器中创建 CSS 变量。虽然这不是直接解决问题的方案，但可以作为替代方案来避免规则重复的问题。

2. 巧妙的规则嵌套方法

henrikvilhelmberglund 提出了一种巧妙的解决方案：将多个规则嵌套在同一个选择器内部。通过这种方式，可以强制 UnoCSS 将相关属性合并到同一个选择器块中。

示例配置：

rules: [
  ['.light-mode', { 
    '--color-primary': '#000',
    '--color-secondary': '#fff'
  }]
]

这种方法虽然有些"hacky"，但确实能够实现 CSS 规则的合并优化。

3. 使用预检(preflights)机制

更优雅的解决方案是利用 UnoCSS 的预检机制。开发者可以：

1. 通过快捷方式检测需要添加的 CSS 变量
2. 将这些变量存储在一个对象中
3. 在预检阶段使用该对象生成最终的 CSS

这种方法更加结构化，也更符合 UnoCSS 的设计理念。

技术原理分析

UnoCSS 默认不合并相同选择器的规则，这是由其核心设计决定的。UnoCSS 采用按需生成 CSS 的原则，每个规则都是独立处理的，缺乏对规则上下文的全面了解，因此难以实现自动合并。

对于需要合并规则的场景，开发者需要主动收集相关属性，然后在适当的阶段（如预检或通过嵌套规则）统一输出。这实际上是一种"提前收集，延迟生成"的策略。

最佳实践建议

1. 对于主题变量：优先考虑使用专门的预设（如 unpreset/unocss-preset-theme），它们已经实现了优化的变量管理方案。

2. 对于自定义变量：

   • 少量变量可以使用嵌套规则的方法
   • 大量变量建议采用预检机制，通过 JavaScript 对象管理变量

3. 性能考量：在大型项目中，CSS 文件大小的优化可能带来明显的性能提升，值得投入时间实现规则的合并。

总结

UnoCSS 作为原子化 CSS 引擎，其设计初衷是提供高度灵活的样式生成能力。虽然默认不合并相同选择器的规则，但通过合理的配置和技巧，开发者仍然可以实现 CSS 输出的优化。理解 UnoCSS 的工作原理，选择适合项目规模的解决方案，是使用 UnoCSS 的高级技巧之一。

对于追求极致性能的项目，建议采用预检机制来管理全局样式和变量，这既能保持代码的组织性，又能实现最优的输出结果。