
本文介绍在 Next.js 项目中使用 SCSS 模块化样式时,如何禁用默认的「文件名_类名_哈希」命名规则,实现更简洁的类名(如 splashContent_3R9Lp),提升 DOM 可读性与调试效率。
本文介绍在 next.js 项目中使用 scss 模块化样式时,如何禁用默认的「文件名_类名_哈希」命名规则,实现更简洁的类名(如 `splashcontent_3r9lp`),提升 dom 可读性与调试效率。
在 Next.js 中启用 CSS Modules(如 .module.scss)后,Webpack 默认会通过 css-loader 对类名进行局部作用域处理,其默认的 getLocalIdent 函数会将文件名、原始类名与哈希值拼接(例如 splash_splashContent_3R9Lp)。虽然这能确保样式隔离,但冗长的类名不利于人工阅读和 DOM 检查。
要移除文件名前缀(即跳过 filename_ 这一段),关键在于自定义 css-loader 的 modules.getLocalIdent 配置。Next.js 13+ 已内置 CSS Modules 支持,无需额外插件;但若你使用的是较老版本(如 Next.js 12 或更早),或需深度定制,可通过 next.config.js 覆盖默认行为。
✅ 推荐配置(Next.js 12/13 兼容)
首先确保已安装 Sass 支持(Next.js 13.1+ 默认内置,旧版需手动安装):
npm install sass # 若使用旧版 next-sass(仅限 Next.js < 13.0.0) # npm install @zeit/next-sass
然后在 next.config.js 中配置 cssLoaderOptions:
/** @type {import('next').NextConfig} */
const nextConfig = {
webpack: (config, { isServer }) => {
// 遍历所有规则,找到 css-loader 配置
config.module.rules.forEach((rule) => {
if (rule.test?.test?.('.module.scss')) {
rule.use?.forEach((loader) => {
if (loader.loader?.includes('css-loader')) {
loader.options = {
...loader.options,
modules: {
...loader.options.modules,
getLocalIdent: (context, _, localName) => localName,
},
};
}
});
}
});
return config;
},
};
module.exports = nextConfig;⚠️ 注意:Next.js 13.0+ 已弃用
@zeit/next-sass,应直接使用内置支持,并通过webpack配置干预css-loader。上述代码兼容现代 Next.js,无需引入第三方包装器。立即学习“前端免费学习笔记(深入)”;
? 效果验证
修改后重启开发服务器,原 JSX:
import styles from './splash.module.scss';
export const Splash = () => (
<div className={styles.splashContent}>
<p>Splash text goes here</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13087" title="Mailtrap Node.js SDK 用于事务性和沙盒电子邮件"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20e352aa140.jpg" alt="Mailtrap Node.js SDK 用于事务性和沙盒电子邮件" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13087" title="Mailtrap Node.js SDK 用于事务性和沙盒电子邮件">Mailtrap Node.js SDK 用于事务性和沙盒电子邮件</a>
<p>一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。</p>
</div>
<a href="/xiazai/skill13087" title="Mailtrap Node.js SDK 用于事务性和沙盒电子邮件" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
</div>
);DOM 中将渲染为:
<div class="splashContent_3R9Lp"> <p>Splash text goes here</p> </div>
类名不再包含 splash_ 前缀,仅保留 原始类名_哈希,显著提升可读性。
? 补充说明与最佳实践
-
哈希不可完全移除:为保障模块化作用域安全,
localName + hash是必需的;纯localName(如splashContent)会导致跨组件样式冲突,不建议启用。 -
调试阶段可临时关闭哈希:开发环境可设
localIdentName: '[name]__[local]',但生产环境务必保留哈希以避免 CSS 冲突。 -
CSS-in-JS 替代方案:若追求极致可控性,可考虑
clsx+styled-jsx或Emotion,但会增加学习成本与包体积。
通过精准定制 getLocalIdent,你既能享受 CSS Modules 的作用域安全性,又能获得干净、语义清晰的 DOM 类名——这是兼顾工程健壮性与开发体验的关键一步。

















