直接结论：styled-components通过${props => ...}函数插值读取props动态生成CSS规则，需避免直接${props.xxx}导致undefined错误；支持theme与props混用、attrs预设属性，但高频变动值不宜传入。
怎样用 props 控制 styled-components 的样式变化
直接结论：styled-components 支持在样式函数中接收组件 props，并据此返回不同 CSS 值，这是最常用、最轻量的动态样式方案。它不是“运行时重写 CSS”，而是基于 props 生成新 class 名并挂载对应样式规则。
关键点在于：样式函数必须是第一级参数（即 styled.div 后紧跟的箭头函数或普通函数），且该函数接收的参数是组件最终 render 时传入的 props —— 包括你显式传的，也包括透传的 className、style 等。
常见错误现象：TypeError: Cannot read property 'theme' of undefined 或样式完全没变，往往是因为忘了把 props 作为参数传进样式函数，或者误把 props 当成组件内部 state 使用。
- 确保使用函数形式定义样式：
const Button = styled.button(({ variant, size }) => ...)，而不是styled.button`...`（后者无法访问 props） - props 必须在 JSX 中显式传入组件，例如
<Button variant="primary" size="lg" />；仅靠父组件 context 或 hooks 无法自动注入到样式函数中 - 避免在样式函数里调用
useState或useEffect—— 这里不是 React 组件上下文，只是纯函数计算
为什么不能在 styled() 外部用 useState 改变样式变量
因为 styled-components 的样式函数只在组件首次创建时执行一次（用于生成 class 名和 CSS 规则），后续 props 变化会触发重新渲染，但样式函数本身不会被重复调用 —— 它早已“固化”为一个静态规则生成器。真正响应变化的是 React 渲染层根据新 props 选择已生成的 class。
立即学习“前端免费学习笔记（深入）”；
换句话说：styled.div(({ active }) => active ? 'color: red;' : 'color: gray;') 并不是每次渲染都跑这个三元判断来改 DOM style，而是提前生成了两个 class（比如 sc-a1b2c3-0 abc123 和 sc-a1b2c3-0 def456），React 根据 active 值决定挂哪个 class 到元素上。
- 性能影响小：CSS 规则在首次渲染后就缓存，不随 props 频繁重计算
- 兼容性好：所有现代浏览器均支持，无 polyfill 需求
- 调试友好：DevTools 中能看到带哈希的 class 名，对应到源码中的样式函数位置（需开启
displayName或 Babel 插件）
怎么安全地传递布尔值、对象或主题色给 styled 组件
props 类型没有限制，但要注意字符串拼接风险和默认值处理。尤其当 props 可能为 undefined 或 null 时，直接解构可能报错，或导致无效 CSS（如 color: undefined）。
推荐写法是用逻辑运算符提供 fallback，或提前做类型归一化：
const Card = styled.div(({ theme, variant = 'default', shadow }) => `
background: ${theme.colors[variant] || theme.colors.default};
box-shadow: ${shadow ? '0 2px 8px rgba(0,0,0,0.1)' : 'none'};
border-radius: ${variant === 'rounded' ? '12px' : '4px'};
`);
- 布尔 props 直接用
??或||转换为 CSS 值更可靠，避免${shadow && '...'}导致空字符串进入 CSS - 对象类 props（如
padding）建议结构化命名，如paddingSize="sm"，而非直接传{ top: '8px' }—— 后者难以参与 CSS 规则哈希计算，也难复用 - 主题色推荐通过
ThemeProvider注入，再用theme参数访问，不要在每个组件里硬编码颜色值
遇到 CSS 优先级冲突或样式未生效怎么办
根本原因通常是：多个 styled 组件嵌套时，class 应用顺序混乱；或你写的动态样式被其他全局 CSS、内联 style、更高权重的选择器覆盖。
最有效的排查路径是打开浏览器 DevTools，看目标元素上实际应用了哪些 class，点击每个 class 查看来源文件和行号，确认是否命中你写的那个样式函数。
- 优先级问题：用
&显式提升作用域，比如const Wrapper = styled.div` & > p { margin: 0; } `；避免依赖后代选择器深度 - 未生效：检查 props 是否真的传到了 styled 组件（不是传给了包装它的 div），可用
console.log打印样式函数参数验证 - 热更新失效：某些 webpack 配置下，修改样式函数后 class 名未刷新，可尝试重启 dev server 或清 localStorage 中的 styled-components 缓存
真正容易被忽略的是：动态样式只对当前组件生效，子组件不会继承父组件的 props —— 如果需要跨层级控制，要么用 ThemeProvider，要么把 props 一层层透传下去，别指望 styled 函数能“感知”到 Context 或 Redux 状态。
