BEM 是最值得坚持的 CSS 命名规范，因其三段式结构（block__element--modifier）天然隔离作用域、避免样式污染、命名即含义，且易于理解、复用和维护。

为什么 BEM 是最值得坚持的 CSS 命名规范

因为它的结构天然隔离作用域，避免样式污染，且命名即含义。不用猜 .btn-primary 是按钮还是容器，也不用翻源码确认 .list-item__title--large 是标题还是副标题——BEM 的三段式：block__element--modifier 直接告诉你层级和状态。

常见错误是把 BEM 当成“加下划线就行”，比如写成 header__nav__link（嵌套过深）或 button--active--disabled（多个 modifier 冲突）。BEM 要求一个元素只属于一个 block，且 modifier 只修饰 block 或 element，不链式叠加。

• search-form ✅ 是 block；search-form__input ✅ 是其子元素；search-form--compact ✅ 是其状态变体
• search-form__input--error ✅ 合理；但 search-form__input--error--focused ❌ 应拆为两个独立 modifier 类，用 JS 控制增删
• 避免在 class 名中出现位置词（如 left-sidebar）、内容词（如 home-page-banner），改用功能语义（sidebar、hero-banner）

如何用 CSS 自定义属性配合命名提升可维护性

命名规范不止是 class 名，CSS 变量（:root 中的 --color-primary）同样需要统一前缀和语义层级。否则很快会出现 --main-color、--primary、--brand-blue 并存，改一个色值要全局搜三次。

推荐按维度分组 + 语义化后缀：--color-text-primary、--space-unit-sm、--radius-card。这样既能被 IDE 自动补全，也能在 DevTools 中快速过滤。

• 所有变量必须带作用域前缀，禁止裸名如 --blue 或 --small
• 数值类变量优先用抽象单位（--space-unit-xs）而非物理单位（--margin-8px），方便主题切换时批量缩放
• 组件级变量应限定在组件选择器内，例如 .card { --card-padding: var(--space-unit-md); }，避免污染全局

哪些 class 命名会直接导致重构灾难

这类名字看似直观，实则锁死 HTML 结构、阻碍复用，且无法通过搜索准确定位使用范围：

• red-text：颜色绑定太死，换主题时得全局替换，还可能误伤其他红色文本
• float-left：描述表现而非意图，Flex/Grid 普及后这个 class 就只剩语义噪音
• header-2025：含年份或版本号，下次改版就得改 class 名，HTML 和 CSS 同步改，CI 构建可能报错
• js-toggle-menu：混入行为逻辑，违反关注点分离；JS 应该靠 data 属性（data-js="toggle-menu"）绑定，而非依赖 class

判断标准很简单：如果删掉这个 class，光看名字完全无法还原它本该承担的 UI 角色，那它就失败了。

PostCSS 插件能帮你守住命名底线吗

能，但只在工程化链路完整时起效。stylelint 配合 stylelint-selector-bem-pattern 插件，可以强制校验 BEM 格式；postcss-bem-linter 能检测 block/element/modifier 的层级合法性。

不过工具只是守门员，不是教练。它不会告诉你 user-card__avatar--large 是否真需要 “large” 这个 modifier，也不会阻止你把一个 modal block 错写成 popup——语义一致性还得靠团队约定和 Code Review。

module.exports = {
  plugins: [
    require('stylelint')(),
    require('stylelint-selector-bem-pattern')({
      preset: 'bem',
      componentName: /^[a-z][a-zA-Z0-9]+$/,
      componentNameStrict: true
    })
  ]
};

BEM 不是银弹，但它是目前最易落地、最容错、最容易让新成员三天内看懂样式结构的方案。真正难的不是写对命名，而是每次写新 class 时，愿意多花三秒想清楚：它代表什么，会被谁复用，半年后别人看到会不会皱眉。