Emotion的css函数每次调用生成新类名导致样式无法复用;根源在于未稳定对象引用、SSR未提取关键CSS且未重置缓存、global/keyframes未手动清理,引发重复注入、CSSOM重算与内存泄漏。

Emotion的css函数每次调用都生成新类名,浏览器无法复用样式缓存
Emotion 的 css 函数本质是纯函数,但它的输出依赖输入对象的引用和序列化结果。如果每次渲染都传入新对象(哪怕内容相同),就会生成全新哈希值、全新类名、新 style 标签规则——浏览器视作全新样式,强制重算 CSSOM,进而触发重绘(甚至重排)。
- 错误模式:
const s = css({ color: 'red' })写在组件函数体内,每次 render 都新建对象 → 每次 class 名不同 - 后果:即使 DOM 节点没变,
class属性字符串变更,浏览器必须重新匹配规则、更新渲染树 - DevTools 中可见大量重复插入的
.css-xxxxxx规则,Recalculate Style时间持续升高
服务端渲染未提取关键CSS,客户端 hydration 时重复注入样式
SSR 场景下,若 Node 端没调用 renderStylesToString 或 extractCritical,HTML 中不包含内联关键样式。客户端 hydration 时,Emotion 会重新执行全部 css 调用,不仅多跑逻辑,还会反复 insertRule —— 这些操作直接触发 layout thrashing 和样式重计算。
- 典型现象:首屏加载后,倒计时数字闪动、按钮颜色跳变,Performance 面板显示密集的
Layout+Paint块 - 根本原因:服务端注入的样式与客户端新生成的规则冲突,浏览器需合并、去重、重建 CSSOM
- 必须同步做两件事:
cache.reset()(客户端 hydration 前),以及确保服务端返回的<style></style>已覆盖所有首屏样式
global / keyframes 规则长期驻留,干扰样式更新链路
global 和 keyframes 创建的 CSS 规则默认永不释放,它们被挂载在全局 sheet 上。当主题切换或微前端子应用卸载时,旧规则仍参与匹配,导致样式计算路径变长、缓存失效、重绘范围扩大。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
- 例如:
global('body', { backgroundColor: theme.bg })每次调用都新增一条 body 规则,而非覆盖 - 动画场景下,
keyframes若用随机 ID(如keyframes`${Math.random()}`),每帧都注册新动画,内存中堆积无用规则 - 检查方式:
cache.sheet.tags.length持续增长且不回落,基本可判定是 global/keyframes 泄漏
类名变动本身不触发重排,但间接放大重绘影响
单纯改 class 字符串不会改变几何属性,所以不直接触发重排。但它会迫使浏览器重新走一遍「匹配 → 计算 → 绘制」链路。在大促页这种每秒 tick 多次的倒计时组件里,类名高频变更(比如 .countdown-digit--active 切换)+ 深层选择器(.countdown .digit.active),会让 Recalculate Style 时间从 2ms 拉到 15ms+,帧率跌破 40fps。
立即学习“前端免费学习笔记(深入)”;
- 真正卡住的不是“加 class”动作,而是浏览器为每个新类名重新验证整条选择器路径
- 尤其当使用
:not(.ignore)或属性选择器([data-active])时,匹配开销指数上升 - 最易被忽略的一点:Emotion 默认开启
speedy: true(动态插入),它虽快但绕过 CSSOM 缓存机制,对频繁更新的节点反而更不利

















