Rsbuild项目中Rspack插件合并问题的技术解析

问题背景

在Rsbuild项目中，当开发者同时使用对象形式和函数形式配置Rspack插件时，会出现插件合并不正确的问题。具体表现为：通过函数形式配置的插件会在最终构建配置中丢失，导致预期功能无法生效。

问题复现

假设我们有三个Rspack插件：

1. RspackPlugin1 - 通过对象形式配置
2. RspackPlugin2 - 通过函数形式配置
3. RspackPlugin3 - 通过对象形式配置

当使用Rsbuild的mergeRsbuildConfig方法合并这三个配置时，最终生成的构建配置中会丢失RspackPlugin2。

技术原理分析

配置合并机制

Rsbuild内部使用reduce-configs库来处理配置合并，该库会递归调用webpack-merge来合并配置对象。对于对象形式的配置，webpack-merge会返回一个新的合并后的对象。

函数式配置的处理

当遇到函数形式的配置时，reduce-configs会直接执行该函数。例如：

rspack(_config, { appendPlugins }) {
  appendPlugins(new RspackPlugin2())
}

问题根源

关键在于appendPlugins函数的实现。该函数操作的是原始的配置对象，而不是webpack-merge返回的新配置对象。因此，通过函数形式添加的插件不会被包含在最终合并后的配置中。

影响范围

这个问题会影响所有同时使用以下两种配置方式的场景：

1. 对象形式：tools.rspack.plugins数组
2. 函数形式：tools.rspack(config, utils)回调函数

特别是在使用一些需要自定义配置的插件（如rsdoctor）时，可能会导致插件配置不生效，从而使用默认配置而非自定义配置。

解决方案建议

临时解决方案

目前可以暂时避免混合使用对象形式和函数形式配置插件。统一使用其中一种方式配置所有插件。

长期修复方案

Rsbuild团队需要修改配置合并逻辑，确保：

1. 函数形式配置操作的是最新的合并后配置
2. 插件添加操作能够正确反映在最终配置中

最佳实践

在配置Rspack插件时，建议：

1. 尽量保持配置方式的一致性
2. 优先使用函数形式配置，因为它提供了更灵活的配置能力
3. 在必须混合使用时，注意检查最终生成的配置是否包含所有预期插件

总结

这个问题揭示了构建工具配置合并机制中的一个边界情况，提醒我们在设计配置系统时需要特别注意不同配置形式之间的交互。对于Rsbuild用户来说，了解这一问题的存在可以帮助避免配置失效的情况，同时也为构建工具的设计提供了有价值的反馈。