第九章、React 样式方案

0 阅读10分钟

React 样式方案:普通CSS + CSS Module

重点:CSS Module 解决全局样式污染、类名冲突,是项目里很常用、上手简单的方案

1. 普通 CSS(全局CSS)

直接写 .css 文件,import './xxx.css' 引入

/* App.css */
.box {
  color: red;
}
import './App.css'
function App() {
  return <div className="box">测试</div>
}

✅ 优点:最简单,不用额外配置

❌ 致命缺点:全局生效,类名同名就互相覆盖 比如A组件写 .box,B组件也写 .box,样式会打架。


2. CSS Module(推荐,解决冲突)

文件命名规则:xxx.module.css(Vite / CRA 默认支持,不用额外装包) 打包的时候,会自动把类名编译成唯一哈希名,变成局部样式,默认不污染全局

/* Button.module.css */
.btn {
  padding: 6px 12px;
  background: #42b983;
  color: #fff;
}
import styles from './Button.module.css'

export default function Button() {
  return <button className={styles.btn}>按钮</button>
}

打包后实际 class 类似:Button_btn__abc123,自动加哈希,不会重名。

几个常用语法

  1. 多个类名
// 方式1:模板字符串
<button className={`${styles.btn} ${styles.primary}`}></button>
// 方式2:clsx(推荐,需要安装,方便条件类名)
import clsx from 'clsx'
<button className={clsx(styles.btn, styles.primary)}></button>
  1. 想要全局样式 :global() module 默认局部,如果某个类希望全局生效:
/* Button.module.css */
:global(.global-text) {
  font-size: 16px;
}

组件里直接写,不用 styles.xxx

<div className="global-text"></div>
  1. 组合样式 compose(部分构建工具支持)
.base {
  border-radius: 4px;
}
.primary {
  composes: base;
  background: blue;
}

❗ 常见坑

  1. 文件名必须带 .module.css,少了 module 就变成普通全局css
  2. 类名不要用横杠 - 也能写,但 JS 里 styles.btn-primary 会报错,推荐驼峰 btnPrimary
/* 不推荐 */
.btn-primary {}
/* 推荐 */
.btnPrimary {}
  1. 不能直接在开发者工具写固定类名覆盖,因为类名带哈希;要用 :global 或者更高权重选择器

预处理器:SCSS / Less

一句话:是 CSS 的增强语言,不是浏览器原生识别,打包时编译成普通 CSS;常和 CSS Module 一起搭配使用(xxx.module.scss)

共同点

  • 支持变量、嵌套、混合mixin、函数、导入、条件判断
  • 解决原生CSS重复代码、不好维护的痛点
  • Vite / CRA 都需要安装对应的预处理器依赖,不用改webpack配置

1. Less(比较简单,国内老项目多见)

安装:

npm install less -D

后缀 .less,可以写成 Button.module.less 开启CSS Module隔离

// 变量
@primary-color: #1677ff;

// 嵌套(非常常用)
.card {
  padding: 12px;
  &:hover { // & 代表自身 .card
    background: #f5f5f5;
  }
  .title {
    color: @primary-color;
  }
}

// mixin 混合,复用代码
.border-radius(@r:4px) {
  border-radius: @r;
}
.btn {
  .border-radius(6px);
}

2. SCSS(Sass,现在新项目更主流,推荐优先掌握)

注意:现在主流是 SCSS(后缀 .scss,大括号写法,和css语法接近);老Sass是缩进语法(.sass,很少用)

安装:

npm install sass -D

文件:Button.module.scss

// 变量 $
$primary-color: #1677ff;

// 嵌套
.card {
  padding: 12px;
  &:hover {
    background: #f5f5f5;
  }
  .title {
    color: $primary-color;
  }
}

// mixin 复用
@mixin radius($r:4px) {
  border-radius: $r;
}
.btn {
  @include radius(6px);
}

// 继承 extend
.base {
  border: 1px solid #eee;
}
.primary {
  @extend .base;
  color: blue;
}

// 运算
$w: 100px;
.box {
  width: $w / 2;
}

✅ SCSS 和 Less 核心区别(面试常问)

  1. 变量符号
  • Less:@变量名
  • SCSS:$变量名
  1. 函数、内置工具:SCSS 更丰富,生态更好
  2. 团队现状:新React项目大多选SCSS,老项目很多Less
  3. 两者都可以配合 CSS Module:xxx.module.scss,自动哈希隔离,互不冲突

🧩 在React里怎么用(Vite)

直接引入即可:

import styles from './Button.module.scss'
export default function Button(){
  return <button className={styles.btn}>按钮</button>
}

⚠️ 重要坑点

  1. 预处理器只是编译工具,浏览器最终拿到的还是普通CSS,没有运行时能力

  2. 嵌套不要写太深!一般建议最多 2~3 层,不然打包后选择器权重太高,后期很难覆盖

  3. 和 Tailwind 对比:

    • SCSS/Less:单独写样式文件,适合复杂组件、主题、大量样式复用

    • Tailwind:原子类,写在className上,很少单独写css

      很多项目搭配:SCSS + CSS Module,或者直接Tailwind

CSS-in-JS:styled-components + Emotion

一句话总结:把CSS写在JS代码里面,JS负责生成样式,运行时注入样式到页面;不需要单独的 .css/.scss 文件。

适合:动态样式多、组件库;缺点:有运行时开销,现在新项目热度不如Tailwind、CSS Module。

1. styled-components(最老牌、生态最大)

安装

npm install styled-components

基础示例

import styled from 'styled-components'

// 直接生成带样式的组件
const Button = styled.button`
  padding: 8px 16px;
  border: none;
  background: #1677ff;
  color: white;
  border-radius: 4px;
  &:hover {
    background: #0958d9;
  }
`

// 直接像普通组件使用
function Demo() {
  return <Button>点击我</Button>
}

动态传参(核心优势,面试常考)

const Button = styled.button`
  background: ${props => props.primary ? '#1677ff' : '#fff'};
  color: ${props => props.primary ? '#fff' : '#333'};
`

// 使用
<Button primary>主按钮</Button>
<Button>普通按钮</Button>

扩展、继承样式

const BaseBtn = styled.button`
  padding: 6px 12px;
  border-radius: 4px;
`
const PrimaryBtn = styled(BaseBtn)`
  background: blue;
  color: white;
`

2. Emotion(和styled-components同类,性能更好、轻量)

两种写法:模板字符串写法 / css属性写法 安装

npm install @emotion/react @emotion/styled

写法1:styled 写法(和styled-components几乎一样)

import styled from '@emotion/styled'
const Box = styled.div`
  color: red;
  padding: 10px;
`

写法2:css prop 写法(更灵活,很多人喜欢)

import { css } from '@emotion/react'

const style = css`
  color: green;
  padding: 8px;
`
function Demo() {
  return <div css={style}>emotion测试</div>
}

✨ CSS-in-JS 共同优点

  1. 天然隔离样式:自动生成唯一类名,不存在样式冲突,不用CSS Module
  2. 动态样式极其方便:直接读取props、state,不用拼接className、不用写大量class判断
  3. 可以直接使用JS变量、函数,不用预处理器的变量
  4. 不用管理一堆css文件

⚠️ 共同缺点(重点,面试高频)

  1. 运行时开销:浏览器运行JS的时候才生成样式,有额外性能消耗;打包体积更大
  2. 首屏会有闪屏风险(SSR场景如果处理不好)
  3. 样式和JS逻辑混在一起,复杂页面阅读起来比较乱
  4. 现在很多大厂逐步减少CSS-in-JS,转向Tailwind / CSS Module + SCSS

常见坑

  1. 不要大量用它做静态样式,静态样式交给CSS Module/SCSS更合适;动态样式多的时候才适合
  2. React18+SSR场景,CSS-in-JS需要额外做服务端样式收集,不然会有水合报错
  3. 调试的时候,class名是随机哈希,不如css module直观

原子化 CSS:Tailwind CSS

一句话:不是预处理器、不是CSS-in-JS,是原子工具类框架,提前写好一堆极小的通用样式类,直接在 className 上组合使用,现在React新项目非常主流。

核心思想:不再自己新建css文件写一堆 .btn-primary {},而是拼原子类。

✅ 基础示例(Vite+React)

先回忆安装:Vite项目安装 tailwindcss postcss autoprefixer,执行初始化命令,配置好 tailwind.config.js 和全局css引入。

// 原来CSS Module写法:引入styles,写className={styles.xxx}
// Tailwind 直接写在标签上
function Demo() {
  return (
    <button className="px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600">
      按钮
    </button>
  )
}

解释:

  • px-4:左右padding
  • py-2:上下padding
  • bg-blue-500:背景色
  • text-white:文字白色
  • rounded:圆角
  • hover:bg-blue-600:hover状态

常用特性

  1. 响应式前缀(断点) sm: md: lg: xl:,屏幕大于对应断点才生效
<div className="text-sm md:text-base lg:text-lg">自适应文字</div>
  1. 状态前缀 hover: focus: active: disabled:
<button className="disabled:bg-gray-300 disabled:cursor-not-allowed">
  禁用样式
</button>
  1. 任意值语法(非常好用) []
<div className="w-[300px] h-[200px] bg-[#f0f0f0]"></div>
  1. 提取复用样式:@apply(写在全局css里)
/* index.css */
@layer components {
  .btn-base {
    @apply px-4 py-2 rounded;
  }
  .btn-primary {
    @apply btn-base bg-blue-500 text-white hover:bg-blue-600;
  }
}
<button className="btn-primary">主按钮</button>

⚠️ 官方建议:少用 @apply,优先直接拼原子类;大量 @apply 就退化成写传统css了,失去原子化优势。

  1. JIT 即时编译(现在默认开启) 只打包你代码里用到的类,没用到的全部丢弃,打包出来css体积很小,这是Tailwind能落地的关键。

✅ 优点

  1. 不用来回切css文件,样式和DOM写在一起,开发速度极快
  2. 天然没有类名冲突,不需要CSS Module
  3. 统一设计规范,颜色、间距、圆角都在配置文件统一管控
  4. 打包体积可控(JIT)
  5. 配合React组件封装,业务效率很高

❌ 缺点(面试高频)

  1. className很长,标签臃肿,视觉上一堆类名
  2. 上手有学习成本:要记大量缩写(px、py、bg、text)
  3. 复杂动态样式、大量组合样式,写起来会很繁琐
  4. 设计改动大的时候,多处class要同步修改

🧩 常见搭配

  • 大部分团队:Tailwind + clsx(用来动态拼接条件类)
import clsx from 'clsx'
function Btn({active}){
  return (
    <button className={clsx(
      'px-4 py-2 rounded',
      active ? 'bg-blue-500' : 'bg-gray-200'
    )}>
    </button>
  )
}

⚠️ 重要坑

  1. 不要在js变量里拼接字符串类名!Tailwind JIT扫描源码,字符串拼接的类识别不到
// ❌ 错误!JIT识别不了
const size = 'px-4'
<div className={size} />
// ✅ 正确:用完整字面量,或者 tailwind-merge + clsx
  1. 第三方UI库(AntD)和Tailwind一起用,容易权重冲突,需要注意

面试一句话总结: Tailwind 是原子化CSS框架,基于JIT编译,把样式拆成最小单元,直接在className组合;没有运行时,开发效率高,缺点是标签class冗长;适合业务页面开发,现在React新项目非常流行。

全部样式方案汇总对比(React 项目)

先把所有方案列出来:

  1. 原生 CSS
  2. CSS Module(常搭配 SCSS/Less 预处理器)
  3. SCSS / Less(预处理器,不是独立样式方案,是增强CSS)
  4. styled-components / Emotion(CSS-in-JS)
  5. Tailwind CSS(原子化CSS)

一句话前置区分: SCSS/Less 是编译增强工具,本身不能独立隔离样式;其余是独立样式组织方案。

总表

方案隔离方式有无运行时编译时机优点缺点适合场景
原生CSS无,全局无打包时直接输出最简单,零依赖类名冲突、容易污染全局全局重置、公共主题样式
CSS Module + SCSS哈希类名,局部隔离无编译打包阶段稳定、无运行损耗、写CSS习惯友好、支持嵌套变量需要单独css文件,频繁切换文件大型复杂业务组件、后台系统、需要大量自定义样式
styled-components / Emotion(CSS-in-JS)自动生成唯一类名✅ 有运行时JS运行时生成样式动态样式天然方便,直接读取props,组件自包含运行时开销、SSR容易水合报错、打包体积偏大组件库、动态样式非常多的组件;现在业务项目变少
Tailwind CSS(原子化)不需要隔离,类名唯一无(JIT编译)打包编译时按需抽取开发快,不用切css文件,规范统一,最终css很小className 很长,需要记缩写,复杂动态不好写绝大多数新业务页面、H5、后台管理,当下主流

重点细节对比(面试高频)

1. CSS Module + SCSS

✅ 优势:

  • 最稳妥的传统方案,没有任何运行时风险
  • 熟悉CSS的人上手快,支持嵌套、变量、mixin ❌ 痛点:
  • 组件多了,一堆css文件,来回切换
  • 动态class要靠 clsx 拼接

2. CSS-in-JS(styled-components / Emotion)

✅ 优势:

  • 动态样式天花板,state/props直接控制样式

  • 样式和组件绑定在一起,不用外部文件 ❌ 痛点:

  • 运行时成本:浏览器跑JS生成样式,首屏、大量渲染时会有性能压力

  • React18 SSR/RSC 适配麻烦,容易水合不匹配

    Emotion 比 styled-components 体积更小、性能更好

3. Tailwind(原子化)

✅ 优势:

  • JIT只打包用到的样式,最终css体积很小
  • 开发速度最快,不用起名、不用写css文件 ❌ 痛点:
  • 模板臃肿,一长串class,可读性差
  • 不适合极度复杂、大量自定义动画的场景
  • 不能直接字符串拼接class(JIT扫描限制)

4. SCSS / Less 定位提醒

它只是语法糖,本身不解决样式污染! 如果你直接写 .scss 而不是 .module.scss,依然是全局样式,照样会冲突。

选型口诀(面试直接背)

  • 老项目维护、复杂定制组件、团队习惯写css:CSS Module + SCSS
  • 做组件库、组件动态样式特别多:Emotion(优先)/ styled-components
  • 新项目、后台、H5,追求开发速度:Tailwind
  • 全局重置、公共样式:原生CSS

常见组合搭配(真实项目里最常见)

  1. 方案A:Tailwind + clsx + tailwind-merge(现在最多)
  2. 方案B:CSS Module + SCSS(中大型传统业务)
  3. 方案C:CSS-in-JS(多用于组件库,业务页面很少)
  4. 极少:Less + CSS Module(老旧后台)