BEM类名必须带block前缀(如user-card__avatar),因其是所有权声明,明确“这是谁的avatar”,避免样式跨模块泄漏;禁止嵌套选择器以保障性能与DOM结构解耦;修饰符必须用--而非-或_,以确保语义清晰、工具可识别、状态可枚举。

因为BEM不是“更优雅的命名”,而是把协作中必然发生的样式冲突,提前变成可 lint、可搜索、可归属的字符串问题——名字长一点,人少 debug 一小时。
为什么 BEM 类名必须带 block 前缀(如 user-card__avatar)
不带前缀的 avatar 或 card__avatar 在百人项目里等于没命名:它不回答“这是谁的 avatar?”
真实场景下,header__logo 和 modal__logo 可能用同一套 SVG 但尺寸/颜色/交互完全不同;没有 block 前缀,CSS 就只能靠父选择器硬锁,结果 HTML 里加个 <section> 就失效。
常见错误:.logo img 这种规则会意外命中所有 logo,连邮件模板里的 <img class="logo"> 都被改掉。
block 前缀本质是所有权声明:每个类名自带模块上下文,grep 搜 user-card 就定位到全部相关样式和模板片段。
为什么 BEM 禁止嵌套选择器(如 .card .card__title)
浏览器匹配 .card .card__title 是从右往左回溯:先找所有 card__title 元素,再逐个查父级是否含 card 类——DOM 越深、元素越多,Recalculate Style 时间越长。
而 .card__title 是单类名,直接哈希查找,性能差可达 4 倍以上(尤其在低端 Android 设备上)。
更关键的是维护成本:.card .card__title 暗示“这个 title 必须在 card 下”,但组件复用时,它可能被塞进 <aside> 或 SSR 直出的 Java 模板里,结构一变样式就崩。
实操建议:
• Sass 中禁用 & 嵌套生成空格选择器,例如避免写 .card { &__title { } }
• 构建后用 grep -r "\.[a-z]\+ \.[a-z]" dist/ 扫描残留空格
• DevTools Elements → Styles 面板里点开任意规则,确认选择器不含空格、不带标签名
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
为什么修饰符必须用 -- 而非 _ 或 -(如 button--primary)
-- 是 BEM 的语义分隔符,不是装饰。它明确告诉团队:“这是 block 或 element 的状态变体”,而非新 block 或视觉工具类。
用 button_primary 容易和 button-icon 混淆,也难被 stylelint-selector-bem-pattern 自动识别;用 button-primary 则和工具类(如 text-center)无法区分,后期 CI 检查失效。
常见踩坑:
• 把响应式类写成 hidden-md —— 它脱离 block 上下文,无法校验归属,且移动端逻辑散落在各处
• 写 button--primary--large--disabled —— 这违反单一职责,应拆成 button--primary button--large button--disabled,每个修饰符独立生效、可被主题系统单独接管
• 在 Vue/React 中传参拼接时漏空格:className={`button${isPrimary ? '--primary' : ''}` → 实际输出 button--primary,但缺少基础类 button,样式直接丢失
立即学习“前端免费学习笔记(深入)”;
为什么国外团队用 BEM 而不是 CSS-in-JS 或 scoped
CSS-in-JS(如 styled-components)在 SSR、微前端、SEO 场景下有运行时依赖和哈希类不可控问题;Vue 的 scoped 用属性选择器(.btn[data-v-xxx]),既不能防止外部 .btn 污染,又让后端模板工程师看不懂类名含义。
BEM 类名是纯字符串契约:search-form__input--invalid 这种写法,Java 工程师写 FreeMarker 模板时也能照抄,审计时可直接关联到前端组件目录,无需查 JS 逻辑。
真正容易被忽略的是边界感:BEM 只管业务组件(user-card),不管工具类(u-text-center)、主题变量(theme-dark)或归一化规则(reset-list)——硬塞进去只会让命名膨胀、语义失焦,最终退化成另一种混乱。

















