用途:在编写 React 组件样式、选择 CSS 方案、实现响应式设计或管理 CSS 架构时提供决策指引,防止全局样式冲突等常见错误。
主要能力:给出样式方案决策树与对比(CSS Modules、Tailwind CSS、内联样式、CSS-in-JS、全局 CSS),并说明各自的运行时开销、作用域与 TypeScript 支持。推荐以 CSS Modules 为主,Tailwind 为强替代;内联样式仅用于运行时动态值;CSS-in-JS 仅在需要运行时主题时使用;全局 CSS 仅用于设计令牌与重置。
必要用法:为 .module.css 添加 TypeScript 声明;用 clsx() 或 cn()(clsx + tailwind-merge)组合条件类名,避免字符串拼接;Tailwind 采用移动优先断点;用 :root 定义 CSS 自定义属性作为设计令牌,配合 data-theme 与 prefers-color-scheme 实现暗色模式;React 19 可用 link 的 precedence 属性控制样式表顺序并去重,React 18 不支持该属性。
限制与警告:内联样式无法表达伪类、媒体查询与动画;普通 .css 导入是全局的,会造成样式冲突;CSS-in-JS 需要客户端运行时,不能用于 React Server Components。
适用场景:React 项目样式选型、组件库样式架构、响应式与暗色模式实现。具体安装命令与版本要求资料未提供。