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:模板字符串
<button className={`${styles.btn} ${styles.primary}`}></button>
// 方式2:clsx(推荐,需要安装,方便条件类名)
import clsx from 'clsx'
<button className={clsx(styles.btn, styles.primary)}></button>
- 想要全局样式 :global() module 默认局部,如果某个类希望全局生效:
/* Button.module.css */
:global(.global-text) {
font-size: 16px;
}
组件里直接写,不用 styles.xxx
<div className="global-text"></div>
- 组合样式 compose(部分构建工具支持)
.base {
border-radius: 4px;
}
.primary {
composes: base;
background: blue;
}
❗ 常见坑
- 文件名必须带
.module.css,少了 module 就变成普通全局css - 类名不要用横杠
-也能写,但 JS 里styles.btn-primary会报错,推荐驼峰btnPrimary
/* 不推荐 */
.btn-primary {}
/* 推荐 */
.btnPrimary {}
- 不能直接在开发者工具写固定类名覆盖,因为类名带哈希;要用
: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 核心区别(面试常问)
- 变量符号
- Less:
@变量名 - SCSS:
$变量名
- 函数、内置工具:SCSS 更丰富,生态更好
- 团队现状:新React项目大多选SCSS,老项目很多Less
- 两者都可以配合 CSS Module:
xxx.module.scss,自动哈希隔离,互不冲突
🧩 在React里怎么用(Vite)
直接引入即可:
import styles from './Button.module.scss'
export default function Button(){
return <button className={styles.btn}>按钮</button>
}
⚠️ 重要坑点
-
预处理器只是编译工具,浏览器最终拿到的还是普通CSS,没有运行时能力
-
嵌套不要写太深!一般建议最多 2~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 共同优点
- 天然隔离样式:自动生成唯一类名,不存在样式冲突,不用CSS Module
- 动态样式极其方便:直接读取props、state,不用拼接className、不用写大量class判断
- 可以直接使用JS变量、函数,不用预处理器的变量
- 不用管理一堆css文件
⚠️ 共同缺点(重点,面试高频)
- 运行时开销:浏览器运行JS的时候才生成样式,有额外性能消耗;打包体积更大
- 首屏会有闪屏风险(SSR场景如果处理不好)
- 样式和JS逻辑混在一起,复杂页面阅读起来比较乱
- 现在很多大厂逐步减少CSS-in-JS,转向Tailwind / CSS Module + SCSS
常见坑
- 不要大量用它做静态样式,静态样式交给CSS Module/SCSS更合适;动态样式多的时候才适合
- React18+SSR场景,CSS-in-JS需要额外做服务端样式收集,不然会有水合报错
- 调试的时候,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:左右paddingpy-2:上下paddingbg-blue-500:背景色text-white:文字白色rounded:圆角hover:bg-blue-600:hover状态
常用特性
- 响应式前缀(断点)
sm:md:lg:xl:,屏幕大于对应断点才生效
<div className="text-sm md:text-base lg:text-lg">自适应文字</div>
- 状态前缀
hover:focus:active:disabled:
<button className="disabled:bg-gray-300 disabled:cursor-not-allowed">
禁用样式
</button>
- 任意值语法(非常好用)
[]
<div className="w-[300px] h-[200px] bg-[#f0f0f0]"></div>
- 提取复用样式:
@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了,失去原子化优势。
- JIT 即时编译(现在默认开启) 只打包你代码里用到的类,没用到的全部丢弃,打包出来css体积很小,这是Tailwind能落地的关键。
✅ 优点
- 不用来回切css文件,样式和DOM写在一起,开发速度极快
- 天然没有类名冲突,不需要CSS Module
- 统一设计规范,颜色、间距、圆角都在配置文件统一管控
- 打包体积可控(JIT)
- 配合React组件封装,业务效率很高
❌ 缺点(面试高频)
- className很长,标签臃肿,视觉上一堆类名
- 上手有学习成本:要记大量缩写(
px、py、bg、text) - 复杂动态样式、大量组合样式,写起来会很繁琐
- 设计改动大的时候,多处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>
)
}
⚠️ 重要坑
- 不要在js变量里拼接字符串类名!Tailwind JIT扫描源码,字符串拼接的类识别不到
// ❌ 错误!JIT识别不了
const size = 'px-4'
<div className={size} />
// ✅ 正确:用完整字面量,或者 tailwind-merge + clsx
- 第三方UI库(AntD)和Tailwind一起用,容易权重冲突,需要注意
面试一句话总结: Tailwind 是原子化CSS框架,基于JIT编译,把样式拆成最小单元,直接在className组合;没有运行时,开发效率高,缺点是标签class冗长;适合业务页面开发,现在React新项目非常流行。
全部样式方案汇总对比(React 项目)
先把所有方案列出来:
- 原生 CSS
- CSS Module(常搭配 SCSS/Less 预处理器)
- SCSS / Less(预处理器,不是独立样式方案,是增强CSS)
- styled-components / Emotion(CSS-in-JS)
- 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
常见组合搭配(真实项目里最常见)
- 方案A:
Tailwind + clsx + tailwind-merge(现在最多) - 方案B:
CSS Module + SCSS(中大型传统业务) - 方案C:CSS-in-JS(多用于组件库,业务页面很少)
- 极少:Less + CSS Module(老旧后台)