跳到正文

组件状态和就近差异样式(3):SCSS、Less、Stylus 与 PostCSS 的维护成本

组件状态和就近差异样式

  1. 根状态、BEM 与样式隔离
  2. 选择器简写的匹配边界
  3. SCSS、Less、Stylus 与 PostCSS 的维护成本(当前)

模板将 is-ready 对应的 BEM 状态放在 upload-card 根节点,preview 和 button 是它的后代。希望在子元素的基础样式附近表达根状态差异,同时减少重复的 Block 名。下面固定这条 DOM 关系,比较不同工具究竟保存了选择器值、名称字符串,还是嵌套层级。

保存名称、保存值与引用层级的差别

SCSS 与 Less 的根名称复用

目标选择器是 .upload-card--is-ready .upload-card__preview,状态属于根节点,差异落到后代。直接写完整关系时,每个 Element 都要重复根名称:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}
.upload-card--is-ready .upload-card__button {
  border-color: #1976d2;
}

这个写法语义最清楚,只是重复比较多。可以用 $root 保存根选择器,减少重复的 Block 名,生成的选择器关系保持不变。

这里用的是后代关系:#{$root}--is-ready & 里,& 仍然指向当前子元素选择器,左边是根状态选择器。它不是 .is-ready#{&} 那种拼接场景,所以 Vue scoped + BEM 这条路不需要把 @at-root 当成必要写法。

.upload-card {
  $root: &;

  &__preview {
    opacity: 1;

    #{$root}--is-ready & {
      opacity: 0.72;
    }
  }

  &__button {
    border-color: #b8c4d6;

    #{$root}--is-ready & {
      border-color: #1976d2;
    }
  }
}

输出仍然是完整 BEM 祖先关系:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}

.upload-card--is-ready .upload-card__button {
  border-color: #1976d2;
}

这里保存的 $root 是求值时的选择器值。Sass 的 & 表达式可以参与变量赋值和插值;即使后面进入 &__preview,$root 仍然保存 .upload-card。重命名组件时,改根选择器就能让这些状态关系一起更新。

如果项目使用 Less,不能把 SCSS 里的 $root: & 原样搬过去。Less 支持变量插值,也支持父选择器 &,这里可以把 Block 名保存成普通字符串:

.upload-card {
  @root: upload-card;

  &__preview {
    opacity: 1;

    .@{root}--is-ready & {
      opacity: 0.72;
    }
  }

  &__button {
    border-color: #b8c4d6;

    .@{root}--is-ready & {
      border-color: #1976d2;
    }
  }
}

输出仍然是同一条完整 BEM 祖先关系:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}

.upload-card--is-ready .upload-card__button {
  border-color: #1976d2;
}

这两种方案的行数差不多,维护成本主要来自信息重复:Less 的 .upload-card 和 @root: upload-card 都包含 Block 名,重命名或复制组件时要同时检查两处。SCSS 的 $root: & 直接从当前位置取值,只维护根选择器即可。

这里的 @root 和 SCSS 的 $root 名字相似,但含义不同。Less 变量遵循延迟求值和作用域查找规则,写下一个 & 并不能得到 Sass 那样的根选择器快照。以 Less 4.9.1 为例:

.upload-card {
  @root: &;

  &__preview {
    @{root}--is-ready & {
      opacity: 0.72;
    }
  }
}

实际输出是:

.upload-card__preview--is-ready .upload-card__preview {
  opacity: 0.72;
}

--is-ready 被接到了 Element 上,而模板把状态放在 .upload-card 所在的根节点。代码能编译,但选择器没有表达需要的 DOM 关系。

如果某个组件里只出现一两处根状态影响子元素,直接写完整选择器也可以:

.upload-card {
  &__preview {
    .upload-card--is-ready & {
      opacity: 0.72;
    }
  }
}

这比为了少写一次根 class 再包一层 mixin 或 detached ruleset 更值得保留。抽象本身也有理解成本;当重复只是一两个完整 Block 名时,直接写清楚通常更好。

因此,在这个场景里比较 SCSS 和 Less,重点是根选择器能否直接复用、重命名需要维护几处信息,以及是否值得为了减少重复再加封装。根状态和子元素联动这件事,二者都能做到。

Stylus 有直接引用初始选择器的语法

Stylus 可以用 ~/ 初始引用指向选择器嵌套的第一层。在单一组件 Block 开始的样式里,这一层正好就是要复用的组件根选择器:

.upload-card
  &__preview
    opacity 1

    ~/--is-ready &
      opacity .72

  &__button
    border-color #b8c4d6

    ~/--is-ready &
      border-color #1976d2

其中 ~/ 取 .upload-card,后面的 --is-ready 拼成根状态;空格后的 & 仍然取当前 Element。Stylus 0.64.0 编译得到的状态选择器如下,省略基础样式:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}

.upload-card--is-ready .upload-card__button {
  border-color: #1976d2;
}

这种写法不用再保存一个变量,也不用重复 Block 名。子元素继续嵌套时,初始引用保持不变:

.upload-card
  &__actions
    &__button
      ~/--is-uploading &
        opacity .5

输出是 .upload-card--is-uploading .upload-card__actions__button。~/ 也可以写成 ^[0];数字 0 表示选择器链的第一层,和向上数一层的相对引用不同。

初始引用依赖的是源码嵌套层级。它不会识别哪个 class 在业务上代表组件。如果在最外面套一层页面选择器:

.page
  .upload-card
    &__preview
      ~/--is-ready &
        opacity .72

实际输出会变成:

.page--is-ready .page .upload-card__preview {
  opacity: 0.72;
}

这时引用的是 .page,已经偏离组件根状态。采用 ~/ 的组件样式要从 Block 开始;外部祖先约束放在需要它的分支里,不要把所有组件样式包进一个外部选择器。

如果更习惯显式命名,也可以用 selector()保存当前编译后的选择器,再用插值引用:

.upload-card
  root = selector()

  &__preview
    {root}--is-ready &
      opacity .72

在这个单一 Block 示例中,它与 ~/--is-ready & 的输出一致。对于多分支选择器、外部包装和 mixin,仍应分别检查输出;把选择器保存下来不等于已经解决了所有拼接语义。

SCSS 保存选择器、Less 重复 Block 名、Stylus 引用第一层的差异

这张图只比较同一个 Block 下的引用来源。三种方案都能生成正确的根状态关系,区别在于根名称从哪里来、改名需要同步几处信息,以及源码嵌套变化是否会影响引用。

PostCSS 要分清嵌套展开与祖先引用

PostCSS 提供 CSS 语法树和插件执行机制,具体的嵌套、变量和祖先引用由插件实现。名字很相近的两个插件,采用的是不同语义:

  • postcss-nested展开 Sass-like 嵌套,支持 &__preview 这样的后缀拼接。
  • postcss-nesting实现标准 CSS nesting,& 表示选择器关系,不能当成 BEM 字符串前缀。

只用 postcss-nested:可以就近写,但要重复根 class

下面这段只需要 postcss-nested:

.upload-card {
  &__preview {
    .upload-card--is-ready & {
      opacity: 0.72;
    }
  }
}

输出能表达正确的根状态关系:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}

它满足差异就近放置的要求,但 .upload-card--is-ready 仍然要手写。postcss-nested 本身不提供 Sass 的 $root: & 变量语义;要避免重复根 class,还需要其他能力。

postcss-nested-ancestors:按层级取得祖先选择器

postcss-nested-ancestors提供 ^&,表示从当前选择器上下文回退一级。它先处理祖先引用,再由 postcss-nested 展开嵌套:

import ancestors from 'postcss-nested-ancestors';
import nested from 'postcss-nested';

export default {
  plugins: [ancestors(), nested()],
};

在 Element 里回退一级,正好取得 Block:

.upload-card {
  &__preview {
    ^&--is-ready & {
      opacity: 0.72;
    }
  }
}

PostCSS 8.5.30、postcss-nested-ancestors 3.0.0 与 postcss-nested 9.0.1 的实际输出是:

.upload-card--is-ready .upload-card__preview {
  opacity: 0.72;
}

它可以省掉重复的根 class,但 ^& 是相对层级引用。中间新增一层 Element 后,要相应改成 ^^&:

.upload-card {
  &__actions {
    &__button {
      ^^&--is-ready & {
        opacity: 0.72;
      }
    }
  }
}

这会得到 .upload-card--is-ready .upload-card__actions__button。如果仍然写一个 ^,状态就会落到 .upload-card__actions 上。相比 Stylus 的 ~/,这种写法更依赖使用点距离根节点有几层。

插件需要在嵌套树仍然存在时取得祖先。把输入先用 postcss-nested 处理成扁平 CSS,再交给祖先插件,本次验证会残留错误的 ^ 选择器。配置采用官方建议的顺序,并检查真实产物;PostCSS 插件还有不同执行 hook,不能只交换数组中两个名字,就认定已经模拟了两次独立处理的时序。

该插件的 Known issues还说明,同一条选择器里混用不同深度的祖先占位符有已知限制。本次输入 ^&--is-ready ^^&--is-active & 会收到 warning,并把两个状态都拼到同一层祖先上;不要把这类输出当作可靠的状态组合方案。

同样是去掉重复根 class,初始引用和相对祖先引用在增加层级后的区别

current-selector 加变量插件:也能保存根,但组合更多

postcss-current-selector可以把声明值中的 %@ 替换成当前选择器。再配合 postcss-simple-vars 和 postcss-nested,可以写成:

.upload-card {
  $root: % @;

  &__preview {
    $(root)--is-ready & {
      opacity: 0.72;
    }
  }
}

这里 $(root) 是变量插件的插值语法,不能和 Sass 的 #{$root} 混用。本次按 currentSelector()、simpleVars()、nested() 组合,能够生成 .upload-card--is-ready .upload-card__preview;多个独立 Block 的输入也检查过了。

这条路线具备保存根选择器的能力,但同时引入选择器提取、变量替换和嵌套展开三项插件约定。复用已有插件链时可以评估它;只为了这一种状态写法从成熟预处理器迁过去,新增的维护项往往比少写的几个字符更多。

标准 nesting:支持状态联动,不提供 BEM 拼接

标准 CSS nesting 同样可以把差异写在目标元素附近,只要完整写出 Element class:

.upload-card__preview {
  opacity: 1;

  .upload-card--is-ready & {
    opacity: 0.72;
  }
}

postcss-nesting 14.0.3 会输出正确的 .upload-card--is-ready .upload-card__preview。这种方案的成本是 Element 名要写完整,不能继续套用 &__preview 的 Sass-like 拼接习惯。

尤其要注意,转换器能解析某段输入,不代表生成了想要的 class。把下面的代码交给同一版本:

.upload-card {
  &__preview {
    opacity: 0.72;
  }
}

本次实际输出为 __preview.upload-card,其中 __preview 是类型选择器,完全不同于 .upload-card__preview。原生 CSS nesting 的相应写法也不能用于 BEM 后缀拼接,具体语义见 MDN 的说明。

采用标准 nesting 时,还要检查选择器列表与 :is(...) 的特异性。Sass-like 展开器、标准 nesting 插件和浏览器原生 nesting,应分别看待,不能只凭名字里都有 nested 或 nesting 就互换。

选择器能力之外,还要比较日常维护成本

只看这一种根状态关系,SCSS、Less、Stylus 和 PostCSS 插件都能实现。选择工具时,更有区别的是重复信息、嵌套调整和其他语法进入编译器后的行为。

方案 根选择器如何复用 日常需要维护的约定
SCSS $root: & 保存选择器值 在 Block 根部保存;选择器列表和复杂外部包装另行验证
Less 保存 Block 名字符串,或直接写完整根状态 重命名时同步字符串,避免把 @root: & 当成快照
Stylus ~/ 或 ^[0] 引用第一层;也可用 selector() 从组件 Block 开始;不要让外部包装改变第一层
postcss-nested 加祖先插件 ^&、^^& 按层级回退 插件组合、层级变化和不同深度占位符的限制
postcss-current-selector 加变量、嵌套插件 提取 %@ 后再做变量替换 三类插件的语法、执行时机和版本组合
标准 CSS nesting 写完整 BEM class,按祖先关系嵌套 不使用 &__element,检查特异性与目标浏览器

当项目还使用 UnoCSS @apply 时,会遇到另一层解析差异。例如 leading-[1.65] 是 UnoCSS 的任意值工具类,预处理器必须先保留它,UnoCSS 才有机会展开。

以下结果来自 Sass Embedded 1.105.1、Less 4.9.1 和 Stylus 0.64.0,只检查预处理器阶段是否完整保留 @apply 参数:

输入 SCSS Less Stylus
@apply leading-[1.65],按各自语法补分号 保留原参数 解析失败 表达式求值失败
@apply 'leading-[1.65]',按各自语法补分号 保留字符串参数 保留字符串参数 保留字符串参数

SCSS 能直接保留这类任意值。Less 和 Stylus 可以通过引号保护工具类字符串;这是 UnoCSS 支持的写法。最终仍要让 directives transformer 展开这些内容,不能把预处理成功当成样式已经生效。这里说的是 UnoCSS,不能直接推广为 Tailwind @apply 的通用语法。

Less 的额外成本因此可以落到两个具体地方:根 Block 名需要重复维护,部分任意值需要额外的引号约定。它不一定表现为更长的代码,而是开发、重命名和复制组件时需要记住更多条件。

Stylus 用初始引用解决了根名称重复的问题,同时保留缩进语法。如果项目已经完成 formatter、Lint、Vue scoped 和 UnoCSS 构建验证,引号写法也已统一,那么仅为了去掉这一对引号再迁移,收益通常有限。升级编译器后,用最终 CSS 检查这些约定是否仍然成立即可。

新项目没有既有语法偏好时,SCSS 可以作为这一组需求下的默认选择:根选择器可以直接保存,常见 UnoCSS 任意值也能直接通过。已有 Stylus 项目可以继续保留;已有 PostCSS 插件链则按实际需求选择祖先引用或完整 BEM 选择器,不必为了统一写法重新组合整条工具链。

用实际输出复核选择器关系

下面的工作区包含编译脚本、22 个输入及其预期结果,以及本次运行的完整输出。它检查根选择器复用、深层 Element、错误层级、变量捕获、标准 nesting 的拼接边界和任意值解析;正确的选择器还会经过 Vue 3.5.44 的 scoped 编译。标记为 boundary 的用例是反例,测试通过表示错误行为已被如实记录,不表示该写法可以采用。

把工作区的 copy/ 文件保存到本地后,在该目录执行:

pnpm install
pnpm test

脚本只在本地运行,输出 results.json。依赖版本固定在 package.json;快照来自 2026-10-23 的隔离编译,不包含生产构建、CSS Modules 映射或浏览器兼容性承诺。源码中已有的 results.json 可用于对照升级前后的差异。

完整实现与接入示例见选择器编译输入与结果弹窗。

上传组件仍采用根状态入口与就近差异样式;按钮禁用使用原生 disabled 或组件接口。样式状态不能代替键盘与业务行为约束。完整内容见上传组件的完整对照弹窗。

选择工具时保留的判断

同一条正确选择器可以由不同语法生成。根名称是否重复、外层包装是否改变引用、任意值能否通过预处理,以及已有 formatter/Lint/构建链的维护成本,需要一起计算。工具升级后仍应比较最终 CSS,而不只检查编译命令成功。

SCSS、Less、Stylus 与 PostCSS 的编译输入和结果

打开原文件 FILES.json

SCSS、Less、Stylus 与 PostCSS 的编译输入和结果正在加载代码工作区...
上传组件的完整对照

上传组件里的状态与行为

回到上传组件,我更愿意让模板保留一个上传状态入口,让预览图和按钮在各自的样式块里描述变化。前面几种工具都能表达这层关系,差别在于根选择器从哪里取得,以及重命名、增加嵌套时要维护多少约定。

组件代码里只保留状态入口:

<section
  class="upload-card"
  :class="{
    'upload-card--is-ready': fileIsReady,
    'upload-card--is-uploading': fileIsUploading
  }"
>
  <div class="upload-card__preview"></div>
  <button class="upload-card__button" :disabled="fileIsUploading">继续上传</button>
</section>

样式里就近描述差异:

.upload-card {
  $root: &;

  &__preview {
    opacity: 1;

    #{$root}--is-ready & {
      opacity: 0.72;
    }

    #{$root}--is-uploading & {
      filter: saturate(0.7);
    }
  }

  &__button {
    min-width: 120px;

    #{$root}--is-uploading & {
      pointer-events: none;
    }
  }
}

对于「状态集中在根节点,差异落在多个子元素上」的组件,Vue scoped 负责当前组件边界,BEM 负责结构归属,预处理器或 PostCSS 插件让这条关系更靠近被影响的元素。

上传中的按钮禁用要通过原生 disabled 或组件的禁用接口实现。pointer-events: none 只影响指针命中,不能阻止键盘激活,样式状态不能代替行为约束。

选择器链超过三层、状态组合开始互相覆盖时,就该重新看组件结构、状态拆分和样式职责;继续往里嵌套,会让覆盖关系更难判断。