BEM 迁移需先识别高危类名（.btn/.nav/.sidebar等）、混杂类及失控类，再通过语义映射套用新命名，配合@layer分层、属性选择器过渡和Block命名规范确保安全。
别从全局搜索替换 .btn 或 .card 开始——90% 的样式崩坏和 JS 断裂都源于这一步。BEM 不是重命名工具，而是用命名契约显性化组件边界、切断隐式依赖的协作机制。
哪些类名必须优先识别并隔离
不是所有旧类都值得动。先筛出三类高危项，它们在代码里实际充当“隐式接口”：
-
.btn、.nav、.sidebar这类泛化名：语义混杂，可能同时表示按钮、链接、标签，还常被 JS 用document.querySelector('.btn')硬编码绑定 - 高频修改文件里的混杂类：比如
header.css中反复出现的.logo，实际在登录页和后台页承担不同结构职责 - 带
!important或深层后代选择器的类：如#main .content .item a:hover，说明它已失控，靠权重强压而非归属控制
执行命令：grep -r "document\.querySelector\(['\"].*\.[a-z]\+['\"]\)" src/ --include="*.js"，把结果列成迁移清单，这些类不能删，只能加别名过渡。
HTML 不动结构，怎么安全套上 BEM 类名
老项目 DOM 嵌套深、语义乱，硬拆结构会牵连事件绑定和表单校验。务实做法是「语义映射」而非「结构重排」：
立即学习“前端免费学习笔记（深入）”；
- 原代码：
<div class="form"><input></div>→ 改为：<div class="login-form"><input class="login-form__input"></div> - CSS 中立刻删掉所有孤立的
.input、.error规则，只保留.login-form__input和.login-form__input--error - 禁止写
.login-form .input这类后代选择器——它默认你永远不重构父容器，而 BEM 的契约是“删掉login-form，子元素仍能渲染” - 若旧 HTML 已有
class="btn btn-red"，先保留btn-red作别名，新代码只用button--primary，逐步替换
CSS 加载顺序和层叠冲突怎么破
新 BEM 类名写好了，但样式还是被旧 CSS 覆盖？问题不在命名，而在层叠逻辑没理清：
-
<link>必须严格位于旧 CSS 之后（哪怕只是逻辑上后加载），否则.button__text权重再低也压不住#header .nav li a:hover - 用
@layer显式分层：@layer legacy { /* 旧规则 */ }+@layer bem { /* 新 BEM 规则 */ }，现代浏览器按层覆盖，兼容性可查Caniuse - 对旧 DOM 容器加命名空间根类，如
legacy-header，并在其 CSS 开头写.legacy-header { all: unset; }（慎用，仅限强污染场景） - 新 BEM 组件必须显式重置基础样式：
box-sizing: border-box、margin: 0、padding: 0，避免继承旧全局重置的副作用
JS 里硬编码的类名怎么平滑过渡
JS 逻辑断裂比样式错乱更致命。不能直接删 .btn，得让新旧类名共存一段时间：
- 临时改用属性选择器：
document.querySelector('[class*="btn"]')比querySelector('.btn')更安全，能匹配button--primary和遗留btn - HTML 中保留旧类作注释：
<button class="btn /* legacy */ button__base button--primary"> - 真正要删掉旧类名前，必须确认所有
querySelector、classList.toggle、埋点上报、服务端模板渲染都已迁移 - Vue/React 中避免手动拼接：
className={`button ${isDisabled ? 'button--disabled' : ''}`容易漏空格或拼错，改用clsx('button', { 'button--disabled': isDisabled })
最易被忽略的是：Block 名一旦定下，三年内没人敢动它。起错名字（比如 card 而非 product-card）等于埋下全局冲突雷——这不是技术问题，是协作边界的起点。
