必须安装stylelint-selector-bem-pattern插件并配置styleType: "bem",CI中运行npx stylelint "*/.{scss,css}"且失败阻断构建,否则.card-header--large等违规写法无法被识别和拦截。

推行BEM不是靠发文档或开培训就能落地的,它必须嵌入开发流程、工具链和日常编码习惯中——否则三个月后代码里还会冒出 .header .logo 和 .btn-primary 这类写法。
怎么用 stylelint 强制校验 BEM 语法
没有校验的规范等于没规范。BEM 的 __ 和 -- 是硬性语法锚点,所有 lint 工具都靠它们识别结构。光靠人眼检查 SCSS 文件根本不可靠,尤其在 PR 合并前。
- 安装
stylelint-selector-bem-pattern插件,配置规则为{"styleType": "bem"} - 在 CI 中加入
npx stylelint "**/*.{scss,css}",失败则阻断构建 - 禁止出现的写法会立刻报错:
.card-header--large(漏下划线)、.button__icon_error(单下划线)、.card__header--large--dark(修饰符叠加) - 注意:该插件只校验 CSS 写法,不检查 HTML 是否真用了对应类名,需配合自动化截图或 E2E 测试补漏
JS 中动态拼接 BEM 类名的正确姿势
手拼字符串是 BEM 在运行时崩坏的主因:className={`card__title ${isLarge ? 'card__title--large' : ''}` 看似简单,但空格、大小写、连字符漏一个,就导致样式丢失且本地难复现。
阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria
- 统一封装生成函数,例如:
const cn = (block, element, modifier) => `${block}${element ? '__' + element : ''}${modifier ? '--' + modifier : ''}` - 调用时明确归属:
cn('user-card', 'avatar', 'rounded')→user-card__avatar--rounded - 避免在 JSX 中直接写
class="user-card__avatar",哪怕只有一处——它绕过了命名约束,后续无法被工具识别或批量重构 - 若用
clsx或classnames,确保传入的都是完整 BEM 字符串,而非拆开的片段
SCSS 嵌套写法必须收敛到 &__ 和 &--
SCSS 的嵌套能力反而最容易破坏 BEM 封装性。.user-card { .avatar { } } 编译后是 .user-card .avatar,这已经不是 BEM,而是传统后代选择器,DOM 结构一变就失效。
立即学习“前端免费学习笔记(深入)”;
- 只允许使用
&__element和&--modifier语法,禁止任何空格或点号嵌套 - 元素不能跨块定义:
.search-form { &__input { } } .user-card { &__input { } }必须分开,不能合并成.form__input这种泛化名 - 修饰符必须绑定到具体块或元素上,
.button--disabled可以,但.disabled单独存在就是违规 - 文件组织按块划分:
_user-card.scss只含.user-card及其__和--变体,不引入其他块的样式
为什么团队协作中最容易在“边界”上破规
BEM 最脆弱的地方不在新组件,而在老代码迁移、跨团队联调、UI 库对接这些边界场景。比如设计系统提供了一个 Button 组件,但业务方在页面里又写了 <div class="card"><button class="btn">确认</button></div> ——这个 .btn 不属于任何 Block,却实际参与了渲染。
- 所有第三方 UI 库必须提供 BEM 兼容的 class 前缀配置项,否则禁止接入
- 老项目增量改造时,禁止新增非 BEM 类名;已有非 BEM 类必须加白名单声明,并标注废弃时间
- HTML 模板中每个元素最多只写一个 Block 相关类,
class="search-form search-form--fullwidth"是冗余的,应直接写search-form--fullwidth - 真正难的是让所有人接受:BEM 类名不是为了“更长”,而是为了让「谁写的」「属于谁」「什么状态」这三个信息一眼可查——少一个,协作成本就翻倍

















