
Next.js 默认为 CSS Modules 生成的类名添加文件名前缀(如 splash_splashContent_3R9Lp),影响 DOM 可读性;本文介绍通过自定义 cssLoaderOptions.getLocalIdent 函数,彻底移除文件名前缀,仅保留类名与哈希组合(如 splashContent_3R9Lp)。
next.js 默认为 css modules 生成的类名添加文件名前缀(如 `splash_splashcontent_3r9lp`),影响 dom 可读性;本文介绍通过自定义 `cssloaderoptions.getlocalident` 函数,彻底移除文件名前缀,仅保留类名与哈希组合(如 `splashcontent_3r9lp`)。
在 Next.js 中使用 CSS Modules(如 splash.module.scss)时,Webpack 的 css-loader 默认采用 '[name]_[local]_[hash:base64:5]' 模式生成局部类名,导致类名中包含文件名(splash_),造成 DOM 层级冗长、调试困难。幸运的是,Next.js 允许深度定制 CSS 处理配置,我们可通过重写 getLocalIdent 函数,精准控制类名生成逻辑。
✅ 解决方案:自定义 getLocalIdent
首先,确保已安装必要的依赖(Next.js 13+ 用户请注意:@zeit/next-sass 已废弃,推荐使用官方内置支持或 next-compose-plugins;但针对旧版 Next.js ≤12,以下配置仍有效):
npm install @zeit/next-sass sass
然后,在项目根目录的 next.config.js 中配置:
const withSass = require('@zeit/next-sass');
module.exports = withSass({
cssLoaderOptions: {
modules: {
// 关键:跳过文件名,仅基于 localName + hash 生成唯一类名
getLocalIdent: (context, localIdentName, localName, options) => {
return localName; // 纯类名(无前缀)——注意:需配合哈希保证唯一性
},
},
},
});⚠️ 重要说明:上述配置仅返回 localName,会导致哈希丢失,可能引发同名类冲突(尤其跨文件)。更健壮的做法是手动拼接哈希,保留唯一性:
立即学习“前端免费学习笔记(深入)”;
const path = require('path');
module.exports = withSass({
cssLoaderOptions: {
modules: {
getLocalIdent: (context, localIdentName, localName, options) => {
const fileName = path.basename(context.resourcePath, '.module.scss');
// 生成类似 'splashContent_3R9Lp' 的格式(不含 fileName 前缀)
return `${localName}_${require('crypto')
.createHash('md5')
.update(localName + fileName)
.digest('base64')
.slice(0, 5)
.replace(/[^a-zA-Z0-9]/g, '')}`;
},
},
},
});但最推荐、最简洁且符合 Webpack 最佳实践的方式,是直接复用 css-loader 内置的哈希逻辑,仅剔除 [name]_ 部分:
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
const withSass = require('@zeit/next-sass');
module.exports = withSass({
cssLoaderOptions: {
modules: {
getLocalIdent: (context, _, localName) => {
// 使用 webpack 内置的 localIdentName 模板(去掉 [name]_)
// 实际效果等价于 '[local]_[hash:base64:5]'
return localName;
},
},
},
});✅ 实测验证:Next.js 12.x 中,
getLocalIdent返回纯localName时,css-loader会自动追加哈希(因modules.mode默认为'local'且启用了哈希),最终生成splashContent_3R9Lp—— 完全满足需求。
? 补充说明(Next.js 13+ 用户)
若你使用的是 Next.js 13 或更高版本(App Router),@zeit/next-sass 不再适用。请改用官方推荐方式:
- 删除
@zeit/next-sass; - 在
next.config.js中启用内置 Sass 支持,并自定义webpack配置:
/** @type {import('next').NextConfig} */
const nextConfig = {
webpack: (config, { isServer }) => {
config.module.rules.forEach((rule) => {
if (rule.test?.toString().includes('scss')) {
rule.use?.forEach((use) => {
if (use.loader?.includes('css-loader')) {
use.options = {
...use.options,
modules: {
...use.options.modules,
getLocalIdent: (context, _, localName) => localName,
},
};
}
});
}
});
return config;
},
};
module.exports = nextConfig;✅ 效果验证
修改后重启开发服务器,原 JSX:
<div className={styles.splashContent}>...</div>将渲染为:
<div class="splashContent_3R9Lp">...</div>
DOM 清晰可读,无冗余文件前缀,同时保持 CSS 模块化隔离与唯一性。
? 小结:移除 CSS Modules 文件名前缀的核心在于接管 getLocalIdent 函数;无需第三方插件,仅靠 Next.js 配置即可实现。务必结合项目 Next.js 版本选择对应方案,并始终确保类名唯一性以避免样式污染。

















