Rspack v1.3.0-beta.1 版本发布：懒编译中间件与循环依赖检测

2025-06-04 10:00:35作者：伍霜盼Ellen

Rspack 是一个基于 Rust 的高性能前端构建工具，它结合了 Webpack 的生态系统和 Rust 的高效性能。在最新的 v1.3.0-beta.1 版本中，Rspack 带来了两项重要的新特性：懒编译中间件和循环依赖检测插件。这些改进不仅提升了开发体验，也增强了构建过程的健壮性。

懒编译中间件：开发体验的重大提升

懒编译（Lazy Compilation）是现代前端构建工具中一项重要的优化技术，它允许按需编译代码，而不是一次性编译整个项目。在之前的版本中，Rspack 实现懒编译需要启动一个单独的服务来处理特殊请求，这导致了端口、服务器配置和代理不一致的问题。

新版本中，Rspack 将懒编译的核心能力封装成了一个 Express 风格的中间件。开发者只需要几行代码就可以将懒编译能力嵌入到自定义的开发服务器中，解决了多服务实例配置不一致的问题。

对于使用 @rspack/cli 的开发者来说，可以无需任何改动就享受到这一改进。而对于使用自定义开发服务器的开发者，可以通过简单的中间件集成来使用这一功能：

import { experiments, rspack } from '@rspack/core';
import config from './rspack.config.mjs';
import DevServer from 'webpack-dev-server';

const compiler = rspack(config);

const middleware = experiments.lazyCompilationMiddleware(
  compiler,
  { 
    entries: true, // 懒编译入口
    imports: true, // 懒编译动态导入
    ...config.experiments?.lazyCompilation
  }
);

const server = new DevServer(compiler, {
  port: 3000,
  setupMiddlewares(other) {
    return [middleware, ...other];
  },
});

server.start();

这一改进使得懒编译的集成更加灵活和一致，大大提升了开发体验。

循环依赖检测插件：构建质量的守护者

循环依赖是 JavaScript 项目中常见的问题，它可能导致难以调试的行为和性能问题。新版本中，Rspack 引入了一个内置插件 CircularDependencyRspackPlugin 来检测运行时模块之间的循环依赖。

这个插件的独特之处在于它是基于 Rust 实现的，直接与 Rspack 的模块图集成，避免了昂贵的复制和序列化成本。插件会遍历每个入口的模块图来查找所有循环引用，而不是单独检查模块，这意味着它的性能更好。

使用这个插件非常简单：

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

const config = {
  plugins: [
    new rspack.CircularDependencyRspackPlugin({
      failOnError: true, // 发现循环依赖时使构建失败
    })
  ]
}

这个插件可以帮助开发者在早期发现并解决循环依赖问题，提高代码质量和可维护性。

其他重要改进

除了上述两个主要特性外，这个版本还包含了许多其他改进：

CopyRspackPlugin 对齐 Webpack：CopyRspackPlugin 的 transform API 现在与 Webpack 插件对齐，提高了兼容性。
并行处理优化：引入了 par_iter_then_collect 方法来优化并行处理性能。
模块 ID 确定性：修复了 getModuleId 返回类型的问题，确保模块 ID 的确定性。
依赖关系迭代器修复：修复了 compilation.*_dependencies 迭代器在同步调用时忽略新增项的问题。
现代模块系统改进：修正了非导出星号连接计数的问题。