制作ShadowDOM组件避坑指南

本文深入剖析了HTML中Shadow DOM组件样式的真正隔离机制与常见误区，明确指出仅靠scoped属性（已废弃）、BEM命名或外部CSS（哪怕加!important）根本无法实现样式封装——唯有通过attachShadow()创建真实边界，才能触发浏览器在样式计算阶段彻底跳过跨boundary匹配；文章系统梳理了合法穿透方式（:host和::slotted()）、安全注入样式的最佳实践（避免字符串拼接、推荐CSSStyleSheet.adoptedStyleSheets）、第三方CSS的谨慎引入策略，并特别强调Shadow DOM仅隔离样式与DOM查询范围，不隔离JavaScript、事件冒泡及全局对象，破除“完全封装”的认知误区，为开发者提供兼具兼容性、可维护性与规范性的实战避坑指南。

Shadow DOM 组件不是加个 scoped 或写个 class 前缀就能封装的——必须用 attachShadow() 创建真实边界，否则样式照样被全局 CSS 覆盖或泄漏。

为什么 style scoped 和 BEM 类名完全无效

Chrome 120+、Firefox 115+ 已彻底移除 scoped 属性支持，它从未在浏览器中真正实现隔离；BEM 类名如 .card__title 只是命名习惯，h1 { color: red } 这种全局规则依然能穿透覆盖。

根本原因：Shadow DOM 的隔离是浏览器在样式计算阶段就跳过跨 boundary 匹配，不是优先级问题，是“根本看不见”。!important 在这里毫无意义。

• /deep/、::ng-deep、>> 等穿透语法已被全部移除，继续用等于主动放弃兼容性
• 把样式写在外部 或 ` 中拼接样式，会导致