CSS变量能生效是因继承机制跨越shadow boundary，而普通CSS规则受硬性隔离阻断；变量需显式设在宿主上才可被var()读取，非默认穿透。
Shadow DOM 的 CSS 变量不是“穿透”，而是“显式接收”——它不打破隔离，只提供可控的样式钩子。用错方式反而会让组件既不隔离也不灵活。
为什么 var(--color) 能在 Shadow DOM 里生效，但 p { color: red } 不行
浏览器对 CSS 变量的解析是动态、继承式的：外部设置的 --color 会沿 DOM 树向下继承，哪怕穿过 shadow boundary，只要 shadow host 是该变量的继承链一环，内部 var(--color) 就能取到值。而普通 CSS 规则（如 p { color: red }）受 shadow boundary 硬性阻断，根本不会进入 shadow tree 的样式匹配流程。
这意味着：
- 变量传递是单向、显式、可追溯的——你必须在宿主元素（如
<my-button>）上设--bg-color，shadow 内部才可能用到它 - 没声明的变量不会“默认穿透”，
var(--missing, blue)中的blue是 fallback，不是兜底穿透 - 变量名一旦拼错或作用域不匹配（比如设在
<body>而非宿主），就回退到 fallback，不会报错也不会警告
:host 和 :host-context() 怎么配合变量控制宿主外观
仅靠变量只能改 shadow 内部元素的样式；要让主题也影响宿主自身（比如按钮整体圆角、边框粗细），必须用 :host 选择器结合变量。
立即学习“前端免费学习笔记（深入）”；
例如在 shadow 内部写：
:host {
border-radius: var(--button-radius, 4px);
border: var(--button-border, 1px solid #ccc);
}
button {
background: var(--button-bg, #007bff);
}
这样外部只需：
my-button[theme="modern"] {
--button-radius: 8px;
--button-border: 2px solid #0056b3;
--button-bg: #0056b3;
}
注意：
-
:host只能出现在 shadow root 的<style>里，不能写在外部样式表中 -
:host-context(.dark)可响应外部祖先类名，适合暗色模式切换，但性能略低于纯变量方案 - 不要在
:host里用复杂选择器（如:host .inner），它不合法
哪些变量该暴露？哪些坚决不能暴露？
暴露变量 = 开放 API。暴露太多，等于把封装层撕开一道口子；暴露太少，主题定制寸步难行。
推荐分三级管理：
-
必暴露：直接影响视觉风格的核心变量，如
--text-color、--bg-color、--border-radius -
按需暴露：特定场景才需要的，如
--icon-size（仅当组件含可缩放图标）、--spacing-xs（仅当内部有弹性间距） -
绝不暴露：涉及布局逻辑的（
--grid-template）、影响可访问性的（--focus-outline应由框架统一管控）、或与 JS 行为强耦合的（--animation-duration）
一个容易被忽略的点：--font-family 看似安全，但如果组件内用了 font-feature-settings 或 variable font axis，仅靠变量无法完整传递语义，此时应封装成更高阶的 --text-style: headline / body / caption。
SSR 和跨框架场景下变量传递的断裂风险
服务端渲染时，shadow DOM 不会被执行（attachShadow 是客户端 API），所以 SSR 输出的 HTML 中，宿主元素上写的 style="--color: red" 或 class 触发的变量定义，可能在 hydration 前就丢失或未生效。
常见断裂表现：
- 首屏闪动：SSR 渲染出无主题的默认样式，JS 加载后才应用变量
- 微前端中子应用未挂载 shadow root 前，父应用设的变量被丢弃
- React/Vue 组件包裹自定义元素时，变量未通过 props 同步到宿主属性
缓解方式：
- 服务端预设
style属性（如<my-button style="--color: #222">），比 class 更可靠 - 在自定义元素
constructor或connectedCallback中读取宿主当前computedStyleMap()或getAttribute('style')，做一次初始化同步 - 避免依赖全局
:root变量，它在 shadow boundary 外，不可控且易被覆盖
真正难处理的，是变量名冲突和层级覆盖——比如两个不同组件库都用 --primary-color，却指向完全不同色调。这时候没有银弹，只能靠命名空间（--mylib-primary-color）或运行时注入前缀机制来兜底。
