哈希类名是 styled-components 实现样式隔离的核心机制，通过运行时生成唯一类名确保作用域隔离，但导致 DevTools 调试困难、E2E 测试失效、外部覆盖不可靠，且 SSR/CSR 哈希不一致会引发 FOUC。
哈希类名不是 bug，是隔离机制的核心表现
styled-components 生成像 sc-kx8rA 或 css-1a2b3c 这样的类名，不是配置错误或开发疏忽，而是它实现样式作用域隔离的必经路径。它靠运行时为每个组件实例生成唯一哈希，确保同一组件在不同位置、不同 props 下的样式互不干扰。
这意味着你不能在外部 CSS 文件里写 .css-1a2b3c { color: red; } 去覆盖样式——类名每次启动或热更新都可能变，且 SSR 和 CSR 环境下哈希逻辑还略有差异。
哈希类名导致 DevTools 调试和 E2E 测试变复杂
你在浏览器开发者工具里看到的类名是动态生成的，无法预测，也不稳定。这带来两个现实问题：
- 不能靠类名做断点调试（比如在 Styles 面板里搜索
Button找不到对应规则） - E2E 测试中用
document.querySelector('.sc-bdnxRM')会失败，因为类名每次运行都不同 - 想定位某个 styled 组件对应的 DOM 元素，得靠 React DevTools 查组件树，而不是靠 class 属性
覆盖样式必须走 styled 的“嵌套”或“attrs”路径，不能硬写 class
如果你需要定制某处 styled.button 的表现，比如加个特殊边框，有且仅有以下几种安全方式：
立即学习“前端免费学习笔记（深入）”；
- 用
&在模板字符串内嵌套：styled.button`&:hover { border: 2px solid red; }` - 用
attrs注入静态 class：styled.button.attrs({ className: 'legacy-button' })`...`（注意：这个 class 不参与哈希，但需自行保证不冲突） - 用
as替换底层标签并复用样式：StyledButton.as('a')，此时哈希类名仍保留 - 避免直接在 JSX 中写
className="my-override"—— 它会被 styled 自动注入的哈希类名覆盖，除非你用!important（不推荐）
SSR 场景下哈希不一致会导致 FOUC 或样式丢失
服务端渲染时，如果没正确使用 ServerStyleSheet，客户端 hydration 生成的哈希类名和服务器输出的不一致，就会出现样式闪烁（FOUC）甚至部分样式失效。
关键动作只有两步：
- 服务端：用
const sheet = new ServerStyleSheet()包裹renderToString，再调用sheet.getStyleTags()注入 HTML head - 客户端：确保没有重复初始化
StyleSheet实例，尤其在多个 entry 或微前端场景下
哈希类名本身无状态，但它依赖运行时环境的一致性。一旦 SSR 和 CSR 的哈希种子或解析顺序错位，整个样式链就断了。
