Next.js 通过文件后缀和 import 方式启用 CSS Modules:文件名须为 .module.css 等格式,且必须用 import styles from 'xxx' 解构引入,否则样式全局污染。

Next.js 默认支持 CSS Modules,但必须满足文件命名和引入方式两个硬性条件,否则样式会全局污染。
文件名必须以 .module.css 或 .module.scss 结尾
CSS Modules 的启用不是靠配置开关,而是靠文件后缀识别。Next.js 仅对匹配 .*\.module\.(css|scss|sass|less) 的文件自动启用局部作用域编译。
- ✅ 正确:
Button.module.css、header.module.scss - ❌ 错误:
Button.css(会被当作全局 CSS 加载)、styles.module.css.ts(后缀不匹配) - ⚠️ 注意:即使你手动在
next.config.js中配置了css-loader,只要后缀不对,Next.js 就不会走 Modules 流程
必须用 import 语句解构式引入,不能用 require 或全局 link
CSS Modules 的类名哈希化发生在 JS 模块导入时,只有通过 ES import 并解构使用,才能拿到转换后的局部类名对象。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
- ✅ 正确:
import styles from './Button.module.css';<br>return <button classname="{styles.primary}">Click</button>; - ❌ 错误:
import './Button.module.css'; // 类名不可访问,等同于全局注入<br>require('./Button.module.css'); // 不触发模块解析,无哈希类名 - ⚠️ 注意:
styles是一个对象,键是原始类名(如primary),值是生成的唯一哈希名(如Button_primary__abc123),直接写死字符串无效
动态类名拼接会失效,需用计算属性或条件表达式
因为 styles 是对象,不能把变量直接拼进点号访问(如 styles.${type} 会报错),也不能用字符串模板构造键名后取值(JS 对象不支持运行时点号动态解析)。
- ✅ 正确:
const type = 'primary';<br>return <button classname="{styles[type]}">Click</button>; - ✅ 多类组合:
className={`${styles.button} ${styles[variant]}`}或用clsx库 - ❌ 错误:
className={styles.'primary'} // 语法错误<br>className={styles.`${type}`} // 语法错误
最常被忽略的是命名规则和导入方式的耦合性——哪怕只改一个字母(比如 Button.modules.css 少了个 l),Next.js 就彻底绕过 Modules 编译,样式立刻泄漏到全局。调试时优先检查控制台是否出现类似 ./Button.module.css:1:1: Unknown word 的警告,那往往意味着后缀未被识别。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










