讲师中心 微信公众号
AI工具推荐 视频效率加速

CSS开发命名规范指南_深度解读BEM规范在项目中的应用

落瑶酱_7271

落瑶酱_7271

发布时间:2026-04-12 11:24:04

|

1026人浏览过

|

来源于php中文网

原创

BEM 的 __ 和 -- 不能随意更改,因其是工具链识别和自动化处理的语法契约;改为 -element 或 _modifier 会导致 stylelint、VS Code 插件等失效,并引发样式泄漏与匹配错位。

css开发命名规范指南_深度解读bem规范在项目中的应用

为什么 BEM 的 __ 和 -- 不能随便改

BEM 强制用 __ 分隔元素、-- 分隔修饰符,不是为了好看,而是让 CSS 选择器可预测、可扫描、可自动化。一旦改成 -element 或 _modifier,所有基于 BEM 的工具(比如 stylelint-selector-bem-pattern、VS Code 的 BEM 插件、甚至 Webpack 的 CSS 模块化提取逻辑)都会失效或误判。

常见错误现象:.card__header--large 写成 .card-header--large,结果样式在组件复用时意外泄漏,因为 .card-header 可能被其他非 BEM 代码全局污染。

  • 所有元素名必须紧跟 __,前面不能有空格或换行
  • 修饰符必须用 -- 开头,且只能出现在块或元素之后,不能嵌套:❌ .card__header--large--dark → ✅ .card__header--large + .card__header--dark
  • 不推荐用 _ 替代 --,部分老版 PostCSS 插件会把下划线当单词分隔符,导致正则匹配错位

React 项目里怎么让 BEM 和 JSX 不打架

JSX 中写 className="card__header--large" 看着冗长又易错,但硬套模板字符串或函数生成反而增加维护成本。关键是把 BEM 结构“声明化”,而不是“拼接化”。

使用场景:组件需要动态组合多个修饰符,或根据 props 切换元素显隐。

立即学习“前端免费学习笔记(深入)”;

  • 用 clsx 而不是手写三元: className={clsx('card__header', { 'card__header--large': isLarge, 'card__header--sticky': isSticky })}
  • 避免在组件内定义 BEM 子类名(如 const headerClass = 'card__header'),这会让样式和结构耦合,审查 DOM 时无法一眼识别语义
  • 如果用了 CSS Modules,BEM 名字要和 :local(.card__header) 保持一致;否则构建后类名哈希化会破坏 BEM 的可读性

block__element--modifier 这种长名会影响性能吗

纯 CSS 层面,类名长度对渲染性能几乎没影响——浏览器解析的是选择器结构,不是字符数。真正拖慢的,是滥用嵌套选择器去“模拟” BEM,比如写 .card .card__header .card__header--large,这会让 CSS 引擎反复回溯匹配。

CSS工具箱(专业版)
CSS工具箱(专业版)

全功能 CSS 工程手册,覆盖性能优化、无障碍、设计系统与跨浏览器兼容。

下载

性能影响主要来自三处:

  • 开发期:过长类名增加键盘输入和 Git diff 噪声,尤其在多人协作时容易拼错(cardd__header 这类 typo 很难被 lint 捕获)
  • 构建期:如果用 cssnano 启用了 reduceIds,超长类名可能无法被安全压缩
  • 调试期:DevTools 中类名太长会自动折叠,card__content__inner__text--highlighted 看不到全貌,得 hover 才展开

建议单个类名总长控制在 40 字符内,必要时用语义缩写(card__img 而非 card__thumbnail-image),但缩写必须全团队对齐。

哪些情况不该硬套 BEM

BEM 是为“可复用 UI 组件”设计的,不是万能命名银弹。强行套用反而让代码更难理解。

典型误用场景:

  • 页面级唯一区块(如 homepage-hero-banner):没有复用需求,用语义化类名 hero 更轻量,加 BEM 反而显得僵硬
  • 工具类(u-text-center, visually-hidden):这类类名本身已表达意图,BEM 会模糊其职责,变成 utils__text-center 就本末倒置
  • CSS-in-JS 场景(如 Emotion):css`font-size: ${props.size}` 动态样式天然隔离,再套 BEM 类名只是多一层抽象

判断标准很简单:这个样式是否会被复制粘贴到另一个组件里?如果答案是否定的,BEM 就不是必须项。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

5396

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

1157

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2038

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

4106

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

8525

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

7211

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

2357

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

3451

2023.08.22

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn