修饰符命名必须带皮肤上下文，不能只写theme-dark；应使用skin-dark、skin-enterprise等命名空间前缀配合BEM双横线语法，如.btn--skin-dark，并通过@layer控制层叠顺序、JS动态注入class、CSS变量收敛视觉原子以确保多皮肤并存时样式互斥且可预测。
修饰符命名必须带皮肤上下文，不能只写 theme-dark
直接用 theme-dark 这类泛化修饰符，在多皮肤并存时会冲突。比如你同时加载「深色模式」和「企业蓝主题」两个皮肤包，.btn--theme-dark 和 .btn--theme-blue 看似合理，但实际 CSS 优先级相同、无隔离，一旦顺序错乱或重复引入，样式就互相覆盖。
正确做法是把皮肤名作为命名空间前缀：用 skin-dark、skin-enterprise，再配合 BEM 的双横线语法组合修饰符：.btn--skin-dark、.card--skin-enterprise。这样每个皮肤包的 CSS 规则天然互斥，也方便 Webpack 或 Vite 按需提取为独立 chunk。
常见错误现象：import './skins/dark.css'; 后按钮变黑，但切换到企业主题时颜色没更新——本质是两个皮肤包里都定义了 .btn--theme-dark，后者覆盖了前者，而你根本没意识到它们在同一个选择器层级上打架。
skin- 修饰符必须配合 JS 动态 class 切换，不能靠预设 HTML
BEM 修饰符本身是静态的，但皮肤包按需加载意味着皮肤名来自运行时配置（如 URL 参数、用户偏好、API 返回），不是写死在模板里的。所以不能指望 HTML 初始就带 class="header--skin-enterprise"，得靠 JS 注入。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 统一维护一个皮肤状态变量，例如
currentSkin，初始值从localStorage或navigator.colorScheme读取 - 根元素（如
）动态添加data-skin="enterprise"，再用 CSS 属性选择器兜底：[data-skin="enterprise"] .btn--skin-enterprise { ... } - 更推荐方式：用 JS 给关键容器加 class，例如
document.body.classList.add('skin-enterprise')，然后写.skin-enterprise .btn--skin-enterprise——这样 CSS 选择器可预测、易调试，且避免属性选择器性能隐患
皮肤 CSS 文件必须用 @layer 控制层叠顺序
多个皮肤包 CSS 被 import 时，加载顺序决定最终样式。如果 dark.css 在 enterprise.css 之后加载，即使 enterprise 主题本应生效，.btn--skin-dark 仍可能因后加载而胜出。光靠文件引入顺序不可靠，尤其用 dynamic import 或 CSS-in-JS 时。
解决方案是显式声明层叠层级：
@layer skin-base, skin-dark, skin-enterprise;
@layer skin-base {
.btn { background: #fff; }
}
@layer skin-dark {
.btn--skin-dark { background: #1a1a1a; color: #fff; }
}
@layer skin-enterprise {
.btn--skin-enterprise { background: #0066cc; color: #fff; }
}
这样无论 CSS 文件怎么加载、怎么拆包，@layer skin-enterprise 内的规则永远高于 skin-dark，除非你手动调高它的层序。注意：IE 不支持 @layer，如需兼容，改用命名前缀 + !important（不推荐）或构建时注入固定顺序 link 标签。
按需加载皮肤包时，CSS 中禁止使用 @import 或相对路径引用字体/图片
Webpack/Vite 打包皮肤 CSS 时，若里面写了 @import './fonts.css'; 或 background: url('./logo.png');，这些资源不会自动进入对应皮肤 chunk，而是被提升到主包或丢失路径——因为构建工具默认只处理 JS 中的 import，对 CSS 里的引用识别有限。
必须改成：
- 字体用
@font-face+ CDN 或 base64 内联（适合小图标字体） - 图片统一走 JS 加载：皮肤激活时，动态
import()对应皮肤的资源模块，再通过 CSS 变量传入 URL：:root { --skin-logo: url(/skins/enterprise/logo.png); } - 所有路径必须为绝对路径或 public 目录下资源，避免
../assets/这类相对引用
否则你会看到控制台报 404，或者深色模式下图标突然变成 404 占位符——问题不在 BEM，而在构建链路没把 CSS 里的资源纳入依赖图。
真正麻烦的不是写几个 --skin-dark，而是确保每个皮肤的视觉原子（颜色、圆角、阴影、动效曲线）都收敛到变量，且变量能被 JS 安全接管。漏掉一个 border-color 的硬编码值，整个皮肤切换就会卡在某个边框上不动。
