在 vite 项目中,css modules 开箱即用,无需额外安装插件。只需将样式文件的扩展名改为 .module.css(或 .module.scss),然后在 javascript 中导入该文件即可使用其导出的 css 类名映射对象。

如何正确导入并应用模块化的类名
导入 .module.css 文件后,Vite 会导出一个包含所有类名哈希映射的对象。你需要通过解构赋值获取具体的类名,并将其绑定到组件的 className 属性上。这种方式确保了样式的局部作用域,避免了全局命名冲突。

import React from 'react';
// 导入 CSS Modules 文件,默认导出名为 default
import styles from './Button.module.css';
export function Button() {
// styles 是一个对象,键是原始类名,值是生成的哈希类名
// 例如: { primary: '_Button_primary__xyz123' }
return (
<button classname="{styles.primary}">
Click Me
</button>
);
}
上述代码中,Button.module.css 内容如下:
.primary {
background-color: blue;
color: white;
padding: 10px;
}
运行结果:渲染出的按钮元素 HTML 为 ,样式仅作用于该组件内部。
如何处理动态类名与条件样式
当需要根据状态切换多个类名时,不能直接传递整个 styles 对象,而应拼接字符串或使用工具库。推荐使用模板字面量或 classnames 库来组合动态类名,确保每个类名都经过哈希处理。

import React, { useState } from 'react';
import styles from './Card.module.css';
export function Card() {
const [isActive, setIsActive] = useState(false);
// 动态拼接类名
const cardClass = `${styles.card} ${isActive ? styles.active : ''}`;
return (
<div classname="{cardClass}" onclick="{()"> setIsActive(!isActive)}>
Content
</div>
);
}
Card.module.css 内容:
.card {
border: 1px solid #ccc;
}
.active {
border-color: red;
box-shadow: 0 0 5px red;
}
运行结果:初始状态下,元素拥有 _Card_card__abc123 类;点击后,增加 _Card_active__def456 类,实现动态样式切换。
如果类名中包含连字符(如 my-class)该如何访问
当 CSS 类名包含连字符、数字开头或保留字时,无法通过点语法(dot notation)直接访问导出的对象属性。此时必须使用方括号语法(bracket notation)进行访问,例如 styles['my-class']。这是 JavaScript 对象属性访问的基本规则,在 CSS Modules 中同样适用。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











