不能用<link>或@import引入外部CSS到Shadow DOM，因其被浏览器规范强制禁用：<link>不触发fetch、sheet为null；@import同步阻塞渲染、路径易404、构建工具无法识别；唯一可靠方式是CSSStyleSheet+adoptedStyleSheets三步全走。
不能直接用 <link rel="stylesheet"> 或 @import 引入外部 CSS 到 Shadow DOM —— 它们在 shadow root 里完全不生效，且无报错、不可调试。
为什么 <link> 和 @import 在 Shadow DOM 中失效
浏览器规范明确禁止 <link rel="stylesheet"> 在 shadow root 中触发样式加载：它只是个普通节点，link.sheet 始终为 null，控制台静默无视。这不是 bug，是 Shadow DOM 隔离机制的强制行为。
@import 更危险：它同步阻塞渲染，请求路径基于宿主文档 URL（不是组件 JS 所在目录），极易 404；Webpack/Vite 等构建工具完全无法识别它，无法哈希、Tree Shaking 或注入 CSP nonce；CSS 返回 404/500 时，整个 <style> 块被丢弃，控制台零提示。
- 别写
shadowRoot.innerHTML = '<style>@import "./foo.css";</style>' - 别写
shadowRoot.appendChild(document.createElement('link'))并设href - 别指望 SSR 或构建工具自动提取这类引用——它们根本不在依赖图里
正确做法：用 adoptedStyleSheets + CSSStyleSheet
这是目前唯一可控、可构建、可缓存、可热更新的原生方案。三步必须全做，缺一不可：
立即学习“前端免费学习笔记（深入）”；
- 用
new CSSStyleSheet()创建空样式表（Chrome 73+、Firefox 94+、Safari 15.4+ 支持） - 调用
sheet.replaceSync(cssText)（初始化阶段推荐）或await sheet.replace(cssText)注入规则 - 赋值
shadowRoot.adoptedStyleSheets = [sheet]—— 注意这是只写数组属性，不是 setter
示例：
const sheet = new CSSStyleSheet();
sheet.replaceSync(`.card { padding: var(--padding, 1rem); }`);
shadowRoot.adoptedStyleSheets = [sheet];
⚠️ 切勿写 shadowRoot.adoptedStyleSheets = [document.querySelector('link').sheet] —— link.sheet 是未激活只读实例，挂载后样式不生效。
Safari 兼容性兜底必须手动写
截至 2026 年 9 月，Safari 15–17.3 仍存在 replaceSync() 抛错问题。降级逻辑不能省：
- 先检测
'adoptedStyleSheets' in ShadowRoot.prototype - 若支持且
replaceSync不抛错，走CSSStyleSheet路径 - 否则退到
document.createElement('style')+textContent方案
关键点：style.textContent = cssText 有效；但 innerHTML = '<style>...</style>' 会生成文本节点，不进 CSSOM，后续改 textContent 完全无效。
穿透样式只能靠 CSS 变量 + :host，别幻想“全局污染”
外部样式无法直接作用于 shadow 内部元素，但有两个合法穿透通道：
-
:host选择器：让宿主元素（即自定义标签本身）响应外部 CSS，例如my-button { --bg-color: #007bff; }或<my-button style="--bg-color: #007bff;"> - CSS 自定义属性：变量必须声明在宿主上（
style属性或直接命中宿主的 CSS 规则），且每个var()必须带 fallback，如background: var(--bg-color, #007bff);
调试时右键 shadow 内节点 → “Show inherited CSS properties”，能直观看到变量是否被继承、来源是哪儿。漏掉 fallback、变量名拼错、或没挂到宿主上，都会导致样式静默失效——控制台不报错，DevTools 里也看不出异常。
