BEM变量命名必须与类名语义严格对齐,如--button__text--primary-color,前缀、元素、修饰符需一一对应,禁止抽象命名或跨Block共享,变量声明须收敛至Block作用域内。

变量命名必须和BEM类名语义对齐,不能各自为政
很多团队把CSS变量和BEM类名当成两套系统:类名用.button__text--primary,变量却起--btn-text-color或--primary-text。结果是改一个主题色要同步改两处,还容易漏掉——比如--btn-text-color被.input__label意外复用,造成样式漂移。
真正严谨的做法是让变量名直接映射BEM结构:--button__text--primary-color。它不是为了“好看”,而是建立可 grep、可替换、可静态分析的契约关系。SCSS中可以用$button__text--primary-color保持一致,避免驼峰或下划线混用。
- 变量前缀必须与Block名完全一致(
button,不是btn或Button) - Element和Modifier部分用双下划线/双连字符分隔,和类名一一对应
- 禁止用抽象词代替BEM路径,如
--primary-color→ 它无法回答“谁的primary” - 媒体查询相关变量也需归属,如
--button--large--padding-mobile,而非单独的--mobile-padding
SCSS中如何安全生成BEM变量而不破坏封装性
在SCSS里写@each $mod, $val in $button--variants { --button--#{$mod}-color: $val; }看似方便,但会暴露实现细节:一旦$button--variants被其他模块读取或覆盖,整个button块的变量体系就失控。更危险的是用@import "variables"全局共享变量文件——这等于把.card__title和.modal__title的颜色变量绑在一起。
正确做法是变量定义收敛到Block级SCSS文件内,并只通过&上下文注入:
.button {
--button-color: #007bff;
--button__text-color: var(--button-color);
--button__icon-color: var(--button-color);
&__text {
color: var(--button__text-color);
}
&--disabled {
--button__text-color: #6c757d;
}
}
- 所有
--*变量声明必须在Block选择器作用域内,不泄露到全局 - Element变量优先用
var(--block__element)引用,而不是重复定义 - Modifier变量只覆盖必要属性,不重置整个变量集(避免
&--disabled { --button-color: #6c757d; --button__text-color: #6c757d; ... }) - 禁用
@extend跨Block共享变量值,哪怕颜色相同也要各自声明
React + CSS Modules中变量与BEM类名的绑定陷阱
在Button.module.scss里写了.button__icon { color: var(--button__icon-color); },JSX里却用className={styles['button__icon']}——这看似没问题,但实际割裂了变量和类名的生命周期。当组件需要支持暗色模式时,--button__icon-color可能由JS动态注入,而styles['button__icon']仍指向旧CSS模块哈希,导致变量未生效。
根本解法是让变量注入点和类名使用点强绑定:
- 用
styled-components或emotion时,把变量声明放在组件顶层,通过css函数注入:css`--button__icon-color: ${props => props.theme.primary};` - 在CSS Modules中,避免直接访问
styles.xxx,改用clsx组合预定义的Block类名:className={clsx(styles.button, props.disabled && styles['button--disabled'])} - 所有变量必须通过
:host或:root以外的作用域设置,否则无法被CSS Modules局部化 - 禁止在JS中拼接变量名字符串,如
getComputedStyle(el).getPropertyValue('--button__' + part + '-color')——这绕过了BEM语义校验
BEM变量命名最容易被忽略的边界问题
最常被跳过的不是语法,而是“什么时候不该用BEM变量”。比如一个.badge块在多个上下文中复用,它的--badge--status-color本该由宿主块(如.user-card或.notification-list)控制,而不是在badge.module.scss里硬编码。这时变量应升维到容器层,或改用CSS自定义属性继承机制。
另一个隐形坑是响应式变量命名:写--button--mobile-padding违反BEM原则,因为--mobile是断点,不是状态或变体。正确方式是把断点逻辑收口到统一媒体查询文件,变量仍保持语义:--button--compact-padding,然后在@media (max-width: 768px)中覆盖它。
- 跨Block复用的视觉单元(如
.icon、.divider)不应拥有自己的BEM变量集,而应接受父Block注入 - Modifier变量必须可开关,
--button--loading-opacity合法,--button--loading-bg-image-url不合法(URL不是状态,是资源路径) - 所有变量值必须是原子类型(color、size、z-index),禁止复合值如
--button--hover-transform(应拆成--button--hover-scale和--button--hover-transition)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











