Tailwind CSS 4 默认不生成BEM类名，因其content扫描器仅识别原子类，BEM类被当作未声明标识符在tree-shaking阶段删除；需通过safelist正则或@layer components + @apply方式安全保留语义化BEM结构。
Tailwind CSS 4 默认不生成、不保留任何 BEM 类名（如 card__header、button--primary），这不是 bug，而是设计使然：它的 content 扫描器只识别原子类，BEM 类名属于「未声明的自定义标识符」，PurgeCSS 阶段直接静默删除。
为什么 class="card__body" 在浏览器里查不到样式
根本原因不是配置错，是 Tailwind 压根没为它生成 CSS 规则。DevTools 里搜不到 card__body，是因为它从未进入最终 CSS 文件——content 扫描器跳过所有不符合原子命名规则的字符串，card__body 不在白名单里，也不匹配内置正则。
- 验证方式：临时把
content: []改成content: ["./src/**/*.{html,js}"]并设purge: false（仅开发环境），再看是否出现；如果出现，就确认是 safelist 缺失 - 常见现象：团队新人照着 BEM 文档写
form__submit--disabled，但按钮始终无禁用态，连类名都从 DOM 的 computed styles 里消失 - 注意：Tailwind 4 已移除
purge字段，改用content配置，但 PurgeCSS 行为仍在 —— 只不过现在叫「tree-shaking unused classes」
用 safelist 正则安全保留 BEM 类名
这是最轻量、构建无侵入的做法，适合已有 BEM 基础的项目。关键是正则要窄而准，避免漏匹配或误拉进无关词。
- 推荐写法：
/^[a-z]+(__|--)[a-z-]+$/—— 匹配card__header、card--featured、input__label--required，结尾$防止匹配到card__header-extra - 不要写
/card/这种宽泛正则，可能意外保留discard、cardinal等词，污染 CSS 体积 - 多个组件不必堆多条正则，一条通用规则即可覆盖大多数 BEM 模式；若需更细粒度控制，可分组写：
/^user-card(__|--).*/、/^data-table(__|--).*/ - 必须加在
tailwind.config.js的content同级位置，格式为数组：safelist: [/^[a-z]+(__|--)[a-z-]+$/]
用 @layer components + @apply 模拟 BEM 语义结构
这不是“绕过 Tailwind”，而是把 BEM 的意图（块/元素/修饰符）翻译成 Tailwind 能理解、能 tree-shake、能响应式的实现方式。它让 BEM 类名真正承载语义，而非装饰。
立即学习“前端免费学习笔记（深入）”；
- 必须定义在
@layer components块内，否则开启content扫描后会被当作未使用类删掉 -
@apply后只能接已注册的原子类（如@apply p-4 bg-white rounded-t-lg），不能嵌套调用另一个 BEM 类（@apply card__header会报错） - 类名可自由命名：
.card__header、.card__actions--compact都合法，Tailwind 不校验格式，只看你是否在 HTML 中引用 - 禁止在
@apply中写原生 CSS 属性（如transform: scale(0.95)），否则脱离hover:、dark:、md:等响应式链
BEM 类名和 Tailwind 原子类必须职责分离
混用时最容易被忽略的点：BEM 类名不是为了“看起来更规范”，而是当 bg-blue-500 无法回答“这是主操作按钮背景”时，你唯一能靠得住的语义锚点。
- ✅ 正确写法：
class="user-card__avatar w-12 h-12 rounded-full bg-gray-200"——user-card__avatar供 JS 查询、测试定位、快照比对；Tailwind 类管渲染 - ❌ 错误写法：
class="user-card__avatar--large"然后在 CSS 里@apply w-16，这会让修饰符失去独立开关能力，后续 JS 动态切换状态时无法精准控制 - ⚠️ 高危操作：把
button--primary当作@apply bg-blue-600 text-white font-medium的别名，结果所有button--primary实例强耦合，无法单独覆盖某一个实例的背景色 - BEM 分隔符必须严格：
btn__icon--large合法，btn--primary__icon语法无效，BEM 解析器直接忽略
真正难的不是写对正则或 @apply，而是团队对「BEM 类名只负责结构语义、绝不承担视觉实现」达成共识。一旦有人开始在 JS 里通过 document.querySelector('.p-4') 定位元素，整个 BEM 层就坍塌了。
