#CircularCheckRspackPlugin

CircularCheckRspackPlugin 使用轻量实现直接基于 Rspack 模块图检测循环依赖。和已废弃的 CircularDependencyRspackPlugin 相比，它刻意减少了配置项，用于在大型项目和 watch 构建中保持较低运行时开销。

new rspack.CircularCheckRspackPlugin(options);

#示例

import { rspack } from '@rspack/core';

export default {
  plugins: [
    new rspack.CircularCheckRspackPlugin({
      failOnError: true,
      exclude: /node_modules/,
    }),
  ],
};

#选项

#failOnError

• 类型: boolean
• 默认值: false

设置为 true 时，检测到的循环依赖会生成 Error 级别诊断，而不是 Warning 级别诊断。

#exclude

• 类型: RegExp
• 默认值: undefined

如果循环依赖中包含资源路径匹配该正则的模块，则该循环会被忽略。

import { rspack } from '@rspack/core';

export default {
  plugins: [
    new rspack.CircularCheckRspackPlugin({
      exclude: /node_modules/,
    }),
  ],
};

#说明

CircularCheckRspackPlugin 会忽略不会在当前模块初始化阶段同步执行目标模块的依赖类型，例如 import()、import context、HMR accept/decline、resolve/id-only 引用以及 asset/CSS 资源引用。

如果需要兼容 ignoredConnections、onDetected、onIgnored、onStart 和 onEnd，请使用已废弃的 CircularDependencyRspackPlugin。