后台系统里改一个按钮的圆角,从 4px 调到 8px。改完,订单列表页、设置页、登录页的按钮全变了。查代码,三处用的都是全局的 .btn,定义在 main.css 第 120 行。想只改一处,只能加一个更具体的选择器,再写一层 !important。半年后,main.css 涨到一千多行,谁也不敢删任何一条规则。

另一种情况:组件库自带一个 .title,业务页面也写了一个 .title,后加载的覆盖前者,页面标题突然变大。排查半小时,最后发现是 import 顺序变了,因为某次重构把样式导入挪到了下面。

CSS 的问题很少是「语法不会」,而是「没有边界」。全局作用域、层叠规则、隐式加载顺序,让样式之间互相影响,而且影响方式不写在代码里。工程化要做的,就是把这些隐式关系变成显式规则。

这篇讲什么:样式失控的四个来源、预处理器现在还要不要用、PostCSS 到底做什么、CSS Modules 和 @layer 能解决哪一段、样式体积和死代码怎么清。读完你能做到:判断一个项目该用哪种隔离方案;把全局样式拆成可控的模块;不再靠 !important 打赢层叠。

版本说明:Sass 按当前主流的 Dart Sass 1.x 讲,PostCSS 按 8.x、Autoprefixer 按 10.x 讲。原生 CSS 的嵌套、@layer、@scope 支持情况随浏览器版本变化,涉及兼容性的地方会标出来,落地前按自己的目标浏览器核对。

样式失控的四个来源

把锅都推给「CSS 不是编程语言」并不准确。真正让样式变乱的,是四件具体的事:

全局命名空间所有类名共享一个作用域,两个页面写同名类就互相覆盖。
优先级竞争后来的人为了生效不断加选择器权重,最后只能上 !important。
隐式依赖样式是否生效取决于加载顺序、DOM 层级、父级类名,代码里看不出来。
死代码堆积页面删了,样式还在;没人敢删,因为不知道哪里还在用。

四件事里,命名空间是根,另外三个是它的并发症。只要类名还是全局的,你就永远需要靠约定和记忆来避免冲突;约定一旦松动,优先级和死代码问题就会跟着来。

所以讨论「用 Sass 还是原生 CSS」「用 Tailwind 还是 CSS Modules」,本质上是在问:这个项目用什么机制来建立边界。工具只是手段,边界才是目的。

预处理器还要不要用

Sass 和 Less 曾经是前端样式的标配,主要提供四样东西:变量、嵌套、混合(mixin)、函数。现在原生 CSS 已经补上了前两样:

能力Sass原生 CSS
变量$color-primaryvar(--color-primary),还能运行时切换主题
嵌套&:hover原生嵌套已可用,但建议只嵌一层
复用片段@mixin / @include没有直接对应,靠组合类或自定义属性
函数与计算颜色函数、数学函数calc()、color-mix() 覆盖大部分

结论不是「Sass 没用了」,而是「为了变量和嵌套上 Sass,收益已经不大」。真正还值得用 Sass 的场景:项目里有大量基于 mixin 的响应式或排版工具;需要在构建期做颜色计算、循环生成工具类;已有代码库已经深度使用,迁移成本高于维护成本。

反过来说,新项目如果没有这些需求,直接写原生 CSS 加自定义属性,构建链少一层,调试时少一层 sourcemap 映射,是更简单的选择。原生嵌套有一个坑:它和 Sass 的嵌套语义不完全一样,尤其是 & 的拼接规则,混写时容易得到意外的选择器。迁移时逐段改,别整体替换。

PostCSS 不是预处理器,是转换管线

PostCSS 本身几乎不处理语法,它把 CSS 解析成 AST,交给一个个插件去改,再把结果输出。你可以把它理解成「CSS 的 Babel」,但目的不是降级语法,而是做各种转换。

常见插件和用途:

插件做什么是否需要
Autoprefixer按 browserslist 补浏览器前缀需要兼容旧浏览器时用;目标较新可不用
postcss-preset-env把较新的 CSS 语法降级成兼容写法用了新语法且要兼容旧浏览器时用
cssnano压缩、合并、去掉无用规则构建工具已压缩时可不用,避免重复
postcss-import把 @import 内联成一个文件需要合并请求时用;打包工具通常已处理

配置很直接:

// postcss.config.js
export default {
  plugins: {
    autoprefixer: {},
    "postcss-preset-env": {
      stage: 3,
      features: { "nesting-rules": true }
    }
  }
};

几个实际取舍。第一,Vite 生产构建本身会压缩 CSS,再叠一层 cssnano 往往收益很小,还可能和构建工具的压缩顺序打架;先量体积,再决定加不加。第二,Autoprefixer 依赖 browserslist 配置,没配目标浏览器时它按默认值工作,可能补出你根本不需要的前缀,也可能漏掉你真正要支持的版本。第三,PostCSS 插件顺序有影响,postcss-preset-env 通常放在前缀处理之前,按官方推荐排,不要凭感觉。

PostCSS 不能解决样式隔离。它做的是「语法转换」和「产物优化」,类名仍然是全局的。把 PostCSS 当成隔离方案,是常见的误解。

隔离方案:从便宜到彻底

样式隔离有五六条路,成本和效果差别很大。没有绝对最好,只有适不适合当前项目。

命名约定(BEM 等)

零构建成本,靠 block__element--modifier 的命名避免冲突。问题是全靠人守,类名长,重构时改名容易漏。

CSS Modules

构建时把类名哈希成唯一值,天然隔离。Vite 内置支持,改造成本低。缺点是全局样式、动态类名、跨组件复用得额外处理。

框架 scoped

给节点加唯一属性,选择器自动带上作用域。写起来最省事,但深度选择器和子组件样式容易穿透失效。

CSS-in-JS

样式写在 JS 里,按组件生成类名。灵活,但有运行时开销、SSR 复杂度,包体积也会增加。

原子化 CSS

用工具类组合出样式,没有命名负担,设计约束强。代价是模板里类名很长,动态拼接容易漏扫描。

原生 @scope / Shadow DOM

浏览器级隔离,最彻底,但主题、弹层、跨根节点渲染都要额外处理,兼容性也要看目标用户。

大多数业务项目的现实选择是 CSS Modules 加少量全局令牌。它不需要换框架、不需要运行时、构建工具已经支持,改造可以从一个组件开始。组件库或设计系统更适合原子化 CSS 或 CSS-in-JS,因为它们要解决的是「如何强制设计约束」和「如何让使用者少写样式」。

CSS Modules 的基本用法:

/* OrderCard.module.css */
.card {
  padding: var(--space-4);
  border: 1px solid var(--color-border);
}

.title {
  font-size: 16px;
}
import styles from "./OrderCard.module.css";

export function OrderCard({ order }) {
  return (
    <article className={styles.card}>
      <h3 className={styles.title}>{order.id}</h3>
    </article>
  );
}

构建后类名会变成类似 _card_1a2b3 的形式,两个组件写同名 .card 也不会冲突。需要复用样式时用 composes,不要用全局选择器去「借用」另一个组件的类名。

CSS Modules 也有边界:它只隔离「你写的类」,第三方组件库的样式仍然是全局的;动态拼接类名时,构建工具无法静态分析,可能被清理工具误删;测试里不要按哈希类名查询,按角色和文字查(这一点上一篇讲过)。

层叠管理:@layer 和 :where

隔离解决了「谁的类名」,层叠解决「谁的规则赢」。即使类名不冲突,优先级竞争仍然存在:重置样式、基础样式、组件样式、工具类,谁覆盖谁,过去只能靠加载顺序和选择器权重。

@layer 把这件事显式化。先声明顺序,后写的层优先级更高:

@layer reset, tokens, base, components, utilities;

@layer base {
  h1, h2, h3 { margin: 0; }
}

@layer components {
  .card { padding: 16px; }
}

@layer utilities {
  .mt-4 { margin-top: 16px; }
}

关键细节:没有写进任何层的样式,优先级高于所有层。所以迁移时,如果还有大量散落的全局 CSS,@layer 的效果会被它们盖住。要么全部纳入层,要么接受一段过渡期。

:where() 把选择器权重降为零,适合写「基础重置」和「不希望打架的默认样式」:

:where(.card, .panel) .title {
  margin-block: 0;
}

/* 权重为 0,组件自己的 .title 规则更容易覆盖它 */

再配合自定义属性做设计令牌:

:root {
  --color-text: #1c1c1c;
  --color-surface: #ffffff;
  --space-2: 8px;
  --space-4: 16px;
}

[data-theme="dark"] {
  --color-text: #e8e8e8;
  --color-surface: #16181c;
}

令牌要分两层:原始值(--blue-500)和语义值(--color-action)。业务组件只用语义值,换主题或调整品牌色时只改一层。全用原始值,半年后没人知道哪个蓝色该改。

暗色主题还有一个常见问题:主题属性设置得太晚,首屏会闪一下白。解决办法是在 head 里、CSS 加载之前用一小段内联脚本读取本地存储并设置 data-theme,别等 React 或 Vue 挂载后再设。

死代码和体积:先量,再删

样式死代码很难靠肉眼看出来。一个类可能在模板字符串里拼接,可能在第三方组件内部使用,也可能真的没人用了。删之前先量。

Chrome DevTools 的 Coverage 面板能统计本次运行中用到的 CSS 比例,但它只代表当前页面、当前交互,不能直接当删除依据。更稳的做法是:对主要页面各跑一遍,取并集;再用构建产物的体积趋势做辅助判断。

PurgeCSS 一类工具可以按内容文件扫描,删掉没被引用的类。但它只做字符串匹配,遇到动态拼接的类名就会误删:

// 错误示范:构建工具无法静态分析
const className = `bg-${color}`;

// 更安全的写法:完整类名出现在源码里
const className = color === "red" ? "bg-red" : "bg-blue";

用清理工具时,先跑「只报告不删除」模式,对照报告检查可疑项,再把确实动态的类加进 safelist。不要一上来就全量删除,白屏之后再回滚,成本更高。

体积还有另一个来源:重复的基础样式。两个组件库各自带一套 reset,两套按钮样式,最后产物里同样的规则出现多次。定期看构建后的 CSS,按选择器分组,重复的合并掉。

完整场景走查:一千二百行 main.css 的拆解

背景是一个运营后台,三个页面共用一个 main.css,一千二百行,全局类名几十个。问题很典型:改按钮影响所有页面,标题类名冲突,没人敢删样式,构建后 CSS 有 180KB。

第一步,先止血。规定新代码不再往 main.css 里加全局类,新组件一律用 *.module.css。这一步不用改老代码,但阻止问题继续变大。

第二步,抽令牌。把颜色、间距、圆角、字号从散落的十六进制值和像素值里提出来,定义成自定义属性。只做「值替换」,不改结构:#2f6fed 换成 var(--color-action),16px 换成 var(--space-4)。这一步能消掉一批重复,也让后面的主题切换有基础。

第三步,按组件拆模块。订单卡片、筛选栏、表格、弹窗,各自建一个 .module.css,把对应的规则从 main.css 搬过去。搬的时候只改类名引用,不改视觉。每搬一个,就在页面上对比一次截图,避免顺手改坏。

第四步,处理全局层叠。把剩下的全局样式分成 reset、base、components、utilities 四层,用 @layer 声明顺序。这里踩了一个坑:第三方组件库的 CSS 没有分层,优先级高于所有层,导致工具类盖不住它。最后把组件库样式用一个专门的层包起来,并接受它需要更高权重的事实。

第五步,清死代码。用 Coverage 跑完三个主要页面,列出从未出现的类;再全仓库搜类名,排除动态拼接和第三方引用。第一批删了大约 18% 的规则,构建后的 CSS 从 180KB 降到 96KB。第二批更谨慎,只删确认无引用的,降到 64KB。

第六步,加约束。引入 Stylelint,限制选择器最大权重、禁止 ID 选择器、禁止裸 !important(白名单除外)。规则不多,但能阻止新代码继续制造优先级战争。三个月后,!important 的数量从四十多处降到七处,且都有注释说明原因。

整个过程用了大约六周,每周只动一个页面。没有推倒重来,也没有引入新的 CSS-in-JS 运行时。收益不只是体积下降,更重要的是「改一个组件不会再影响别的页面」。

错误现象对照

现象真实原因第一步查什么
改 A 页面样式,B 页面也变了两边共用了全局类名或元素选择器搜该选择器的所有使用处,确认是否该拆成模块
规则写了却不生效优先级不够、层叠顺序不对,或被未分层的样式盖住DevTools 的 Styles 面板看哪条规则胜出,检查 @layer 顺序
生产环境样式丢失清理工具把动态拼接的类名删了看构建前后的类名差异,检查 safelist 和拼接写法
开发正常,构建后顺序变了CSS 导入顺序或拆分策略不同对比构建产物里 CSS 的排列顺序和开发时的加载顺序
暗色主题首屏闪白主题属性在页面绘制后才设置检查设置 data-theme 的脚本位置
CSS 体积只增不减页面删了样式没删,或重复引入基础样式用 Coverage 和构建产物统计,按选择器找重复
测试因为类名变化挂了测试按哈希类名查询元素改成按角色、标签或文字查询
!important 越加越多用权重压制代替结构分层统计数量,改用 @layer 和 :where 重构

边界与代价

CSS Modules 不是免费午餐。每个组件一个样式文件,文件数量会变多;跨组件复用要么用 composes,要么提成公共类,前者增加隐式依赖,后者又回到全局命名。小项目、组件数量不多时,BEM 加一两个全局文件可能更省事。

原子化 CSS 的代价在模板里。类名一长串,业务逻辑和样式混在一起,可读性下降;设计约束强是优点,但前提是团队真的按令牌走,否则会出现「什么值都写死」的原子类,最后比普通 CSS 还乱。动态拼接和清理工具的配合也要专门约定。

CSS-in-JS 的运行时开销不是危言耸听。每次渲染生成样式、插入样式表,组件多时会有可测量的成本;SSR 还要处理样式提取和水合。零运行时的方案能避开这部分,但构建配置更复杂,调试体验也更绕。业务项目没有强需求,不建议为了「样式和组件放在一起」上运行时方案。

@scope 和 Shadow DOM 是最彻底的隔离,但它们改变了样式的作用方式:主题变量要穿透、弹层要挂到正确的位置、第三方组件可能不适应。兼容性也要按目标浏览器核对(支持面还在变化,落地前用 caniuse 一类数据确认,待确认你的用户环境)。

设计令牌和 Stylelint 也会增加前期成本。小团队可以先只做令牌,不急着上全套规则;等样式数量上来、开始出现覆盖战时,再加约束。工程化的节奏应该是「先有问题,再有规则」,而不是反过来。

小结

乱的根本是全局命名空间优先级、顺序、死代码都是并发症;先建立边界,再谈工具。
预处理器不再是默认项变量和嵌套原生已有;mixin 和构建期计算才是 Sass 还值得用的理由。
PostCSS 是转换管线补前缀、降级语法、压缩;它不解决隔离,别指望它管类名。
CSS Modules 加令牌是稳妥组合构建期哈希类名,天然隔离;语义令牌管主题,@layer 管优先级。
清理工具要谨慎先报告再删除,动态类名加 safelist;体积下降要建立在「没删错」上。

当天可以动手的练习:

  1. 把项目里一个全局组件样式改成 *.module.css,确认同名类不再互相影响。
  2. 用 @layer 给 reset、基础、组件、工具类排一次顺序,观察覆盖关系的变化。
  3. 把一个写死的颜色和间距换成自定义属性,再切换 data-theme 验证主题。
  4. 跑一次 Coverage,统计三个主要页面用到的 CSS 比例,列出可疑的死代码。
  5. 用 Stylelint 限制选择器权重和 !important,看现有代码报了多少条。

下一篇讲发布与版本。样式和代码都收拾干净之后,最后一步是把它们交出去:版本号怎么定、破坏性改动怎么让下游知道、灰度发到什么比例、出问题怎么回滚。工程化的闭环不在构建成功,而在「发布之后还能安全地退回来」。