WarnCaseSensitiveModulesPlugin

检测引用的模块名称的大小写冲突,并发出警告。

在不同操作系统中,文件系统对大小写的处理方式可能不同。当代码中引用仅大小写不同的模块名称时,可能会导致跨系统编译时出现意外的错误,这个插件用于预防这种情况。

new rspack.WarnCaseSensitiveModulesPlugin();

注册

rspack.config.js
module.exports = {
  plugins: [new rspack.WarnCaseSensitiveModulesPlugin()],
};

示例

假设项目中存在 utils.js 文件:

src/
  ├── a.js
  ├── b.js
  └── utils.js

当在 a.jsb.js 中引入 utils.js 时,如果引用路径中的大小写不一致,插件将会发出警告。

src/a.js
import { helper } from './utils';
src/b.js
import { helper } from './Utils';

警告如下:

WARNING There are multiple modules with names that only differ in casing.

这个警告提示开发者存在模块命名的大小写冲突,确保相同模块在项目中使用统一的大小写形式。

TIP

WarnCaseSensitiveModulesPlugin 基于模块标识符而非文件系统来判断大小写差异。

ON THIS PAGE