多端适配本质是状态组合爆炸，bem通过语义化修饰符（如--mobile、--dark、--compact）解耦多维变体，结合css自定义属性实现运行时适配，并作为跨技术栈的样式契约保障微前端与ssr一致性。
多端适配本质是状态组合爆炸，BEM用修饰符解耦变体
多端适配不是“写几套媒体查询”就能解决的，而是要应对设备类型（mobile/tablet/desktop）、交互方式（touch/pointer）、上下文密度（compact/comfortable）、主题模式（light/dark/high-contrast）等维度的交叉组合。BEM不靠覆盖样式，而是把每个可变维度显式声明为独立修饰符，比如 product-card--mobile--dark--compact，每个 --xxx 都可单独开关、复用、测试。
常见错误现象：用 @media (max-width: 768px) 直接改 .product-card__title 字体大小，结果在 tablet 横屏下错乱；或把 --dark 和 --mobile 硬编码进一个类里，导致无法单独启用暗色模式。
- 布尔修饰符用于二值状态：
--touch、--rtl、--reduced-motion - 键值修饰符用于多态配置：
--density-compact、--theme-dark、--scale-125（避免用--scale-1.25这类技术值） - 所有修饰符必须绑定到具体 Block 或 Element，不能脱离上下文存在——
button--touch是合法的，但--touch单独出现就是语义断裂
CSS 自定义属性 + BEM 修饰符才是真·运行时适配
纯 BEM 类名只能做静态分支，而真实多端场景需要响应式变量注入（比如触控间距、字体缩放系数）。BEM 修饰符正好充当 CSS 自定义属性的“触发器”：
.button {
--btn-padding-y: 8px;
--btn-padding-x: 16px;
}
.button--touch {
--btn-padding-y: 12px;
--btn-padding-x: 24px;
}
.button__icon {
margin-inline-end: calc(var(--btn-padding-x) / 2);
}
这样，同一套 HTML 和类名，在不同设备上只需切换 button--touch，所有依赖 --btn-padding-x 的子元素自动适配，无需重复写选择器。
- 禁止在修饰符中直接写样式（如
.button--touch { padding: 12px; }），否则无法被子元素继承变量 - 修饰符只负责设置自定义属性，样式逻辑统一收口在 Block 或 Element 基础规则里
- 构建时可通过 PostCSS 插件将
--density-compact映射为预设变量集，兼顾 SSR 可见性与运行时灵活性
微前端和 SSR 场景下，BEM 是唯一能跨技术栈对齐的样式契约
当页面由 Java 模板直出 + React 子应用 + Vue 微模块拼成时，JS 运行时不可靠，CSS-in-JS 无法生效，全局 class 名是唯一可控入口。BEM 把“谁家的组件、什么状态、在哪上下文”全写进类名里，让后端、前端、测试三方拿到的 DOM 结构语义一致。
常见错误现象：Java 模板输出 <div class="btn">，React 子应用也用 <code>btn，结果样式互相覆盖；或 SSR 输出的 user-card--mobile 在客户端 hydration 后被 JS 动态删掉，造成 FOUC。
- 所有服务端模板必须严格遵循项目
bem.config.json中定义的 block 前缀（如checkout-、user-），禁止泛化命名 - 微前端子应用的样式打包必须提取为独立 CSS 文件，并通过
<link rel="stylesheet">加载，而非内联 style 标签——否则无法被父应用的缓存策略管理 - CI 阶段用
stylelint-selector-bem-pattern拦截任何非 BEM 结构的类名（如.btn-mobile或.card .header），否则上线后无法定位样式来源
BEM 的扩展性陷阱：修饰符叠加 ≠ 组合自由
真正难的不是写出 button--primary--large--disabled--touch，而是意识到这种写法已经失控。它意味着你放弃了“状态正交性”——--large 和 --touch 本应互不感知，但一旦连缀，就隐含了“大尺寸按钮必须支持触控”的耦合假设。
容易被忽略的地方：修饰符的粒度必须和业务语义对齐，而不是技术特征。比如“移动端紧凑布局”是一个完整语义单元，应该定义为 --layout-mobile-compact，而不是靠 --mobile + --compact 拼凑——后者在 RTL 场景下可能产生意外冲突，且无法被设计系统主题引擎识别。
- CI 必须拦截双连字符连用（如
button--primary--large），只允许单个--后跟一个语义化单词 - 每个修饰符必须有明确的文档说明其影响范围（是否改变 padding？是否禁用动画？是否影响子元素？）
- 当修饰符数量超过 5 个/块时，应考虑拆分为更细粒度的 Block（如把
form--mobile--compact--dark--loading拆为form+form-layout-mobile+form-theme-dark）
