CSS 模块化架构的演进:BEM、CSS Modules 到 CSS-in-JS 的反思

CSS 模块化架构的演进:BEM、CSS Modules 到 CSS-in-JS 的反思

一、引子:那个 BEM 类名比内容还长的组件

翻到五年前写的代码,一个按钮的 class 是 header__nav--primary-btn__label--is-active。它在 2019 年是正确的------BEM 方法论是当时应对"CSS 全局作用域"问题的最佳实践。但站在 2026 年回头看,这条演进路径上有太多"当时看起来正确,后来发现代价很大"的决策。

CSS 模块化的演进是一场"作用域控制 vs 表达能力 vs 性能"的三角博弈。每一代方案都在优化其中两个维度,代价是牺牲第三个。

二、先把评价标准说清楚

选样式方案时,别只比较写一段按钮样式要几行代码。至少要看四件事:样式能否被安全删除、主题变量是否能统一管理、服务端渲染是否稳定,以及新人能否在不阅读整套约定的情况下修改一个组件。团队若主要维护长期产品,最后两项通常比"首次开发速度"更重要。

也不要把 BEM、CSS Modules 和 CSS-in-JS 当作互斥阵营。一个项目可以用 CSS Modules 处理业务组件,用少量全局 CSS 放 Token 和 reset;已有的 CSS-in-JS 组件也不必为了风格统一而一次性重写。先约束新增代码,再在改动旧页面时顺手迁移,成本更可控。

三、各方案的适用场景与问题

BEM:适合项目初期,维护成本随规模增长

BEM 的核心思想是"用命名约定模拟作用域"。block__element--modifier 的命名模式提供了人工可读的作用域信息。问题是它依赖开发者自律------哪天有人写了 .header .btn 而不是 .header__btn,没有编译器会报错。

适用:简单网站、不需要组件化的小项目。

CSS Modules:2026 年仍然是最佳平衡点

CSS Modules 在编译时对类名进行哈希处理,确保每个组件的样式被隔离到唯一的类名空间。它保留了完整的 CSS 表达能力(不像 CSS-in-JS 限制某些选择器),且没有运行时性能开销(所有处理在构建时完成)。

css 复制代码
/* Button.module.css */
.button {
  /* 编译后: .Button_button_abc123 */
  composes: base from './base.module.css';
  padding: var(--spacing-md);
}

适用 :绝大多数 Web 应用。配合 CSS 自定义属性(Token)和 @layer 管理优先级。

CSS-in-JS:运行时成本被低估了

Styled Components 和 Emotion 在 2020-2024 年间非常流行。它们的优势是"样式和逻辑在一起"的 colocation 理念和动态样式的便利性。

但运行时成本是一个严重问题:

  • 每个样式对象需要序列化 → 注入 <style> 标签
  • SSR 时样式需要额外处理(提取关键 CSS)
  • 包体积增加 12-15KB(gzip)
  • 在 React 18 并发模式下有兼容性问题

2025 年开始,社区明显在回归编译时方案(零运行时 CSS-in-JS 如 Panda CSS、Vanilla Extract,或回归 CSS Modules)。

四、2026 年的推荐架构

复制代码
CSS 架构 = CSS Modules + CSS Custom Properties + @layer

- CSS Modules:组件级作用域隔离
- CSS Custom Properties:设计 Token + 主题切换
- @layer:优先级管理(reset → base → components → utilities)

五、迁移建议

从全局 CSS 或 BEM 迁移时,先找样式冲突最多、改动最频繁的页面作为试点。把公共颜色和间距提取为变量,再迁移组件本身;不要先批量改类名。每迁移一个页面,用视觉回归截图比对桌面和移动端,并检查键盘焦点、禁用态和高对比度主题。这样能把"样式重构"变成可回滚的小批次,而不是一次难以验证的改造。

六、结论

  1. CSS 模块化经历了 BEM(命名约定)→ CSS Modules(编译时)→ CSS-in-JS(运行时)→ 回归编译时四个阶段
  2. 2026 年最佳平衡点是 CSS Modules + CSS 自定义属性 + @layer
  3. CSS-in-JS 的运行时成本(SSR 性能、包体积)是回归编译时方案的主因
  4. BEM 在简单项目中仍然可用,但缺乏编译器级别的安全保障
  5. 零运行时 CSS-in-JS(Panda CSS, Vanilla Extract)是兼顾 colocation 和性能的折中方案
  6. 选择方案时,优先看维护方式和渲染路径,不要只看语法偏好
相关推荐
deli0071 分钟前
12 个请求挤一条连接:HTTP/1.1 队头阻塞 vs HTTP/2 多路复用实测
前端
deli00734 分钟前
TCP 为什么会粘包?4 种拆包方案 49 字节实测对比
前端
deli0072 小时前
32K 上下文塞满后,AI 最先忘掉什么?120 轮对话实测
前端
deli0073 小时前
手机拍灯为什么有一条条黑纹?PWM 240Hz 实测
前端
wangruofeng7 小时前
AI Models 1.1.0 发布,查大模型价格、对比模型和找 API 地址
前端·aigc·ai编程
wangruofeng8 小时前
给前端开发者的 100 个设计参考网站
前端·设计
LinXunFeng11 小时前
拿竞品 App 一扫,技术栈全暴露了
android·flutter·开源
星栈11 小时前
视频即代码,Remotion 能做什么、不能做什么
前端·音视频开发
广州华水科技11 小时前
单北斗GNSS位移监测系统的应用与技术解析
前端
用户479492835691511 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试