使用CSS Module可避免样式冲突并保持组件样式独立，通过命名转换机制将类名局部作用域化。在React中，只需将文件命名为[name].module.css（如Button.module.css），导入后得到类名映射对象，确保样式仅作用于当前组件。全局样式仍可通过普通.css文件引入，而模块化样式需按对象方式访问。支持动态类名拼接与条件渲染，推荐结合clsx等库处理复杂逻辑。可在.module.css中使用:global定义全局样式或通过composes复用其他类，实现灵活的样机组装。命名规范清晰时，CSS Module能显著提升样式的可维护性和隔离性。
在React项目中使用CSS Module可以有效避免样式冲突，同时保持组件样式的独立性。它通过将CSS类名局部作用域化，确保样式只作用于当前组件，非常适合与组件化开发结合使用。
启用CSS Module
CSS Module不是独立工具，而是通过构建配置实现的命名转换机制。在Create React App或自定义Webpack环境中，只需按约定命名文件即可自动启用：
- 将样式文件命名为 [name].module.css（如 Button.module.css）
- React会自动识别 .module.css 后缀并开启模块化处理
- 导入后得到的是一个对象，键为原始类名，值为全局唯一生成的类名
示例：
// Button.module.css
.primary {
background: blue;
color: white;
padding: 10px;
}
// Button.jsx
import styles from './Button.module.css';
<p>function Button() {
return <button className={styles.primary}>点击</button>;
}</p><p>export default Button;</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p>混合使用全局样式与CSS Module
有时需要引入全局样式（如重置样式或设计系统），同时保留局部模块化能力。可以通过不同命名方式区分：
- 普通 .css 文件：全局作用域，直接引入即生效
- 以 .module.css 结尾的文件：启用CSS Module，需通过对象访问类名
例如，在 index.css 中写全局样式：
body {
margin: 0;
font-family: sans-serif;
}
在组件中继续使用模块化样式：
import './index.css'; // 全局生效
import styles from './Card.module.css';
<p>function Card() {
return <div className={styles.container}>内容</div>;
}</p>动态类名与组合样式
CSS Module支持类名拼接和条件渲染，结合JavaScript逻辑更灵活：
- 使用模板字符串组合类名
- 借助 clsx 或 classnames 库简化多条件判断
基础拼接示例：
<div className={`${styles.box} ${props.isActive ? styles.active : ''}`} />
推荐使用 clsx（轻量且常用）：
import clsx from 'clsx';
// npm install clsx
<p><div className={clsx(styles.box, {[styles.active]: props.isActive})} /></p>处理嵌套与继承需求
虽然CSS Module默认局部作用域，但仍可通过 :global 定义或覆盖全局样式：
/* 在 .module.css 文件中 */
.container :global(.highlight) {
color: red;
}
<p>:global(.no-margin) {
margin: 0;
}</p>也可在模块样式中复用其他类（类似继承）：
.error {
padding: 8px;
border: 1px solid #f00;
}
<p>.fatalError {
composes: error from './BaseStyles.module.css';
background: #fee;
}</p>
基本上就这些。只要命名规范清晰，CSS Module能很好地与React组件配合，提升样式的可维护性和隔离性。不复杂但容易忽略细节。
