BEM迁移需优先识别样式强压维稳、JS硬编码类名、泛化类名语义冲突、新代码无强制校验四大风险点,再针对性过渡重构而非全量替换。

看旧CSS里有没有大量 !important 或深层后代选择器
如果有,说明样式已靠权重强压维稳,不是“没用BEM”,而是“BEM契约早被破坏”。这类项目强行全量迁移,等于把所有胶带撕掉再重贴——90% 概率直接散架。真实信号是:#main .content .item a:hover、.page-header .nav li.active a 这类选择器频繁出现,或开发者日常靠加 !important 解决覆盖问题。
查 JS 里有没有硬编码的类名,比如 document.querySelector('.btn')
执行这条命令能快速暴露风险点:grep -r "document\.querySelector\(['\"].*\.[a-z]\+['\"]\)" src/ --include="*.js"。如果结果里有几十个 .nav、.toggle、.error,就别谈“全面迁移”——这些类名已是隐式接口,删或改等于断逻辑。必须先加别名过渡,比如保留 .btn 同时引入 button__base,再逐步收敛。
检查复用模块是否类名泛化,比如 .list 或 .card 被多个不相关页面共用
泛化名本身不是问题,问题是它是否承载了不同语义:登录页的 .list 是用户列表,后台页的 .list 是日志条目,但样式和JS都共用同一套规则。这种场景下,.list 已不是组件,而是“命名污染源”。适合优先重构,但不是全局替换,而是给每个上下文加明确归属:user-list、log-list,再按 BEM 展开子元素。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
确认团队能否接受新增代码立刻启用 BEM,且 CI 中强制校验
全面迁移从来不是改旧代码,而是堵住新代码继续恶化。如果 ESLint / Stylelint 里没配 stylelint-selector-bem-pattern,也没在 CI 中拦截非 BEM 类名,那所谓“全面”只是幻觉。真正有效的起点是:从下一个新组件开始,只允许 search-suggestion__item,不允许 .suggestion-item。其余旧模块,只动高危、高频、多处复用的那 20%,剩下的留着也比乱动强。
立即学习“前端免费学习笔记(深入)”;
最常被忽略的一点:BEM 不是 CSS 语法升级,而是协作边界的显性化。你改一个 .header 类,如果不知道它背后绑着三个页面的 JS 切换逻辑、两个埋点上报字段、一套服务端模板渲染规则,那就别碰——先画清边界,再谈命名。

















