核心是用 CSS 变量实现多租户皮肤切换：在 :root 定义语义化变量（如 --primary-color），按租户动态注入 style 块或 JS 设置 document.documentElement.style，避免硬编码、多套 CSS 或字符串拼接；注意单位处理、作用域控制及 SSR 租户识别。
如何用 CSS 变量实现多租户皮肤切换
核心是把皮肤配置从写死的样式里抽出来，用 :root 定义变量，再按租户动态注入。不是靠复制多套 CSS 文件，也不是靠 JS 拼字符串改样式表——那样维护成本高、缓存不友好、首屏易闪。
实际做法是：在 HTML 的 <head> 里，根据当前租户 ID 加载对应变量值的 <style> 块，或通过 JS 注入 document.documentElement.style。变量名统一用 --primary-color、--header-bg 这类语义化命名，CSS 规则里直接引用。
- 避免在变量值里写单位（如
--spacing-md: 16px），否则无法参与 calc 计算；应写纯数字--spacing-md: 16，使用时写margin: calc(var(--spacing-md) * 1px) - 变量作用域要控制好：全局皮肤变量放
:root，组件级定制放组件根元素上，别污染全局 - 注意 SSR 场景下，服务端需提前知道租户 ID 才能注入正确变量，不能等 JS 执行后再改
CSS-in-JS 方案中怎么安全替换主题 token
像 Emotion、Styled Components 这类方案，主题本质是 JS 对象，皮肤切换就是换这个对象。但直接 ThemeProvider 套两层会导致样式重算开销大，且子组件可能读到旧主题。
关键点在于：主题对象必须 immutable，更新时用新引用替换旧引用；组件内用 useTheme() 或 props.theme 读取，不要缓存 theme 值到本地变量里。
立即学习“前端免费学习笔记（深入）”；
- 别在 theme 对象里放函数或 Date 等非序列化值，会破坏 SSR 一致性
- 如果用 CSS-in-JS 动态生成关键样式（比如按钮背景色），确保该样式规则本身也依赖 theme 变量，而不是只依赖组件 props
- 警惕 CSS-in-JS 的 keyframe 或 @font-face 等全局规则——它们不响应 theme 变更，得单独处理
遇到 “皮肤没生效” 时优先检查哪几个地方
90% 的皮肤失效不是逻辑错，而是加载顺序或作用域问题。先看浏览器开发者工具的 Elements 面板，展开 <html> 元素，确认 style 属性或 :root 下是否真有你设的变量值；再看 Computed 标签页，搜 background-color，看最终值来源是不是你预期的 CSS 规则。
- 检查变量是否被更高优先级的规则覆盖（比如某个 class 里写了
background-color: #007bff !important） - 确认租户标识是否准确传入：URL 参数、子域名、请求头，三者容易对不上；比如开发环境用 localhost，但代码里还按 production 逻辑读 subdomain
- 检查 CSS 文件是否被 CDN 缓存了旧版本，特别是带 hash 的文件名没变但内容变了——这时要清 CDN 缓存，或强制刷新资源 URL
要不要用 CSS 模块或 Shadow DOM 隔离皮肤样式
需要隔离，但不是所有场景都适合用 Shadow DOM。CSS 模块（.module.css）只解决类名冲突，不解决变量和全局规则污染；Shadow DOM 能彻底隔离，但会切断外部皮肤变量继承——:host 里读不到 :root 的 --primary-color，得手动透传。
折中方案更常用：用 BEM 命名 + 租户前缀类（如 tenant-a-button），配合 CSS 变量作用域控制。Shadow DOM 只用于强隔离需求组件，比如嵌入第三方的管理后台 widget。
- Shadow DOM 中想用皮肤变量，得在
:host上显式设置，或用getComputedStyle(host).getPropertyValue('--primary-color')手动读取 - CSS 模块无法跨文件共享变量，得额外配一个
tokens.module.css并在每个模块里@import，不如直接用原生 CSS 变量干净 - 如果项目已用 Web Components，Shadow DOM 是自然选择；否则为皮肤隔离引入它，投入产出比偏低
最麻烦的从来不是怎么切皮肤，而是怎么让字体大小、行高、阴影扩散这些“非颜色”属性也随租户走，还不出布局偏移。这些值往往藏在多个组件的 padding/margin 里，一改就连锁反应——得提前约定一套可组合的 spacing scale 和 type scale，别让设计师随便给个 13.5px。
