BEM命名报错主因是HTML中class含空格或点、构建工具误删修饰符、JS拼接不安全；应禁用cssnano的mergeLonghand等优化，用工具函数生成类名，块级变量挂块选择器下，修饰符变量仅覆盖必要项。
为什么BEM命名一加就报错？class名里不能有空格和点
常见错误是把 BEM 当成写法提示，直接在 HTML 里写 class="header__title--large" 却忘了检查是否被框架自动转义、或被 CSS-in-JS 工具拦截。更隐蔽的是：某些构建工具（如 Vite + PostCSS）默认启用 cssnano，会把重复的 BEM 类名合并，导致 btn btn--primary btn--disabled 被压缩成 btn btn--primary，样式丢失。
- 确保构建配置中禁用
mergeLonghand和reduceTransforms等可能误删修饰符的优化项 - HTML 中的 class 值必须是纯字符串，
class={["header__title", "header__title--bold"].join(" ")}比硬编码更安全 - 避免在 JS 里拼接 BEM 字符串，改用工具函数：
getBlock("button")返回"button"，getElement("button", "icon")返回"button__icon"
CSS变量和BEM混用时，scope到底该挂在哪一级？
BEM 本身不处理作用域，但现代项目常靠 CSS 自定义属性实现主题切换。错误做法是把所有变量塞进 :root，结果 --button-bg 和 --card-bg 冲突；或者全写成 .button--primary { --button-bg: #007bff; }，导致变量无法被嵌套子元素继承。
- 块级变量放块选择器下：
.button { --button-padding: 8px 16px; }，子元素可直接用var(--button-padding) - 修饰符变量只覆盖必要项：
.button--large { --button-padding: 12px 24px; }，别重复定义整个变量集 - 禁止在
.button__text这类元素上声明新变量，它应无条件继承父块上下文
怎么让BEM不拖慢开发？别手写长类名
手动敲 modal__content-wrapper--scrollable 不仅易错，还打断思维流。真实瓶颈不在命名规则，而在编辑器补全和团队一致性。
- VS Code 安装
PostCSS Language Support插件，配合emeraldwalk.runonsave自动格式化 class 属性 - 在组件文件顶部加注释模板：
// @bem button, button__icon, button--loading，供 IDE 提示 - Webpack/Vite 的
css-loader开启modules: { localIdentName: "[name]__[local]___[hash:base64:5]" }仅用于局部模块，BEM 仍走全局 CSS，二者别混用
伪类和响应式断点怎么塞进BEM结构？
很多人卡在 :hover、@media 怎么组织。错误是写成 .button:hover 破坏 BEM 分离原则，或把媒体查询散落在各处导致维护困难。
立即学习“前端免费学习笔记（深入）”；
- 交互状态统一用修饰符：
.button--hovered，由 JS 切换 class，CSS 只管样式 - 响应式规则集中写在块末尾：
.button { ... } .button__icon { ... } @media (min-width: 768px) { .button--wide { ... } } - 避免
@media嵌套在元素或修饰符内部，否则编译后选择器权重爆炸，且无法被 PurgeCSS 安全识别
真正难的不是写对一个组件，而是当 header 里嵌了 nav，nav 里又嵌 dropdown，三层 BEM 块互相传参、共享变量时，哪一层该负责初始化，哪一层该只做渲染——这得靠组件契约，不是靠命名规范能解决的。
