by Rstack Team
我们很高兴地宣布 Rspack 2.1 已正式发布!
值得关注的变更如下:
- 性能提升
- React Compiler Rust 版本
- 构建性能优化
- TypeScript 7 支持
- 更快的循环依赖检查
- 新特性
- 支持
import.meta.glob - 改进内置 CSS 支持
- 支持解析
createRequire - Rspack 魔法注释
- 支持 Source phase imports
- 自动清理持久化缓存
- 产物优化
pureFunctions稳定化- 分支感知的依赖裁剪
- 分支感知的 ESM 导出存在检测
export const值绑定优化- 生态
- TanStack RSC 支持
- Rsbuild
- Rslib
- Rstest
- Rslint
- Rspress
- Rsdoctor
- rspack-merge
性能提升
React Compiler Rust 版本
React Compiler[1] 是 React 官方推出的构建时优化工具,它能在编译阶段自动为组件和 Hook 添加合适的记忆化逻辑,减少手动使用 useMemo、useCallback 和 React.memo 的需要。
过去,React Compiler 主要通过 babel-loader 接入,这会引入额外的 Babel 转换开销,并增加项目构建时间。随着 React Compiler 被移植到 Rust[2],SWC 也已经完成接入。Rspack 2.1 现在可以通过内置 SWC loader 直接启用 React Compiler。
在我们的基准测试中,React Compiler Rust 版本相比 Babel 版本性能提升约 7-13 倍:
| 命令 | React Compiler (Rust) | React Compiler (Babel) | 提升 |
|---|---|---|---|
rspack dev |
0.7 s | 10.6 s | 13.5x |
rspack build |
1.2 s | 9.3 s | 7.4x |
通过 builtin:swc-loader 的 reactCompiler 开启 React Compiler:
// rspack.config.mjsexportdefault {module: { rules: [ { test: /\.(?:js|jsx|ts|tsx)$/, use: { loader: 'builtin:swc-loader', options: { jsc: { transform: { react: { runtime: 'automatic', }, reactCompiler: true, }, }, }, }, }, ], },};
更多配置方式参考 Rspack React Compiler 指南[3]。
构建性能优化
构建性能始终是 Rspack 的核心关注点之一。在基准测试中,Rspack 2.1 相比 Rspack 2.0 的 生产构建性能提升约 16%,HMR 性能提升约 5%。
| 版本 | 生产构建(无缓存) | 生产构建(有缓存) | 热更新 |
|---|---|---|---|
| Rspack 1.7.11 | 3.12 s | 2.09 s | 129 ms |
| Rspack 2.0.0 | 2.66 s | 1.36 s | 113 ms |
| Rspack 2.1.0 | 2.22 s | 1.20 s | 107 ms |
数据来源:rspack-react-10k-benchmark[4]
这些提升主要来自三个方向:对构建主流程的大量微优化,优化模块图和依赖关系等底层数据结构,以及改进 SWC 解析与转换流程。
TypeScript 7 支持
TypeScript 类型检查常常是构建链路中最耗时的环节之一。ts-checker-rspack-plugin[5] 现在支持使用 TypeScript 7(TypeScript Go)进行类型检查。在启用类型检查的构建中,整体耗时可减少约 60%。
在项目中安装 TypeScript 7 RC 版本后即可使用:
pnpm add typescript@rc -D
// rspack.config.mjsimport { TsCheckerRspackPlugin } from 'ts-checker-rspack-plugin';export default { plugins: [new TsCheckerRspackPlugin()],};
更快的循环依赖检查
Rspack 2.1 新增了 CircularCheckRspackPlugin[6],用于替代废弃的 CircularDependencyRspackPlugin[7]。
// rspack.config.mjsimport { rspack } from '@rspack/core';export default { plugins: [new rspack.CircularCheckRspackPlugin()],};
相比旧插件,新的 CircularCheckRspackPlugin 主要有两方面改进:
- 性能更好:旧插件的检测方式更接近从入口展开循环路径,在大型模块图中容易产生重复遍历。新的插件使用更适合循环检测的图算法,一次分析即可找出循环组件,并为每个循环组件生成可读的循环路径,因此在大型项目中检测开销更低。
- API 设计更合理:旧插件的 API 设计不够直观,也和 webpack 生态中常用的
circular-dependency-pluginAPI 不一致。新的插件回到更直接的“检测并报告循环依赖”模型,提供与 webpack 生态更一致的选项设计,整体更容易理解和迁移。
如果你正在使用 CircularDependencyRspackPlugin,建议迁移到 CircularCheckRspackPlugin。对于只需要忽略部分 warning 的场景,可以配合 ignoreWarnings[8] 使用。
新特性
支持 import.meta.glob
Rspack 新增了对 import.meta.glob[9] 的支持。你可以按 glob 模式收集模块,并在需要时再加载它们:
const pages = import.meta.glob('./pages/**/*.js');for (const path in pages) { const mod = await pages[path]( "path");}
这项功能已经在 Vite 和 Turbopack 中实现。Rspack 新增支持后,开发者可以在不同生态工具之间使用更一致、更熟悉的写法,减少切换工具时的认知成本。这也让同时支持多种构建工具的框架和库作者,可以复用更接近的实现。
查看 import.meta.glob 文档[10] 了解完整用法。
改进内置 CSS 支持
Rspack 2.1 进一步改进了 内置 CSS 支持[11]。新增的 css/global 模块类型让 CSS Modules 可以以“默认全局、按需 :local”的方式工作,和 css/module、css/auto 一起覆盖更多作用域组织方式。
CSS Modules 相关能力也继续补齐,支持更多 CSS Modules 语法与行为。
相关配置可参考 module.generator[12] 和 module.parser[13] 的 CSS 选项。
支持解析 createRequire
ESM 模块中没有内置的 require,因此 Node.js 提供了 module.createRequire()[14],允许你在 ESM 中创建一个 require 函数,用于加载 CommonJS 模块。在以往版本中,Rspack 无法静态分析通过这种方式创建出的 require,因此由它加载的模块也无法被正常打包。
Rspack 2.1 新增了 module.parser.javascript.createRequire[15] 选项。开启后,Rspack 会识别从 Node.js module 引入的 createRequire,并将创建出的 require 转换为可静态分析的依赖上下文。这样一来,由它加载的模块会像普通的 require 或 import 一样被打包进产物。
// rspack.config.mjsexport default { module: { parser: { javascript: { createRequire: true, }, }, },};
// index.jsimport { createRequire } from 'module';const require = createRequire(import.meta.url);const value = require('./value.cjs');
这一选项还支持:
- 多种导入形式:支持具名导入、默认导入和命名空间导入,并同时识别来自
module和node:module的导入。 - 自定义来源:除
true外,还可以通过"形式的字符串自定义 specifier 和模块来源,例如"createRequire from module"。 - 静态可分析的参数:
createRequire()的参数需要能被静态分析为 file URL 或绝对路径,例如import.meta.url、new URL('./dir/file.js', import.meta.url)或绝对file:URL。
该选项默认关闭,查看 module.parser.javascript.createRequire[16] 了解更多。
Rspack 魔法注释
Rspack 2.1 为 magic comments[17] 增加了 rspack 前缀支持。现在你可以使用 rspack 前缀声明编译提示:
import(/* rspackChunkName: "dashboard" */ './dashboard');
原有的 webpack 前缀仍然兼容,因此现有项目无需迁移。
查看 magic comments 文档[18] 了解更多。
支持 Source phase imports
Rspack 2.1 支持 TC39 Source Phase Imports[19] 提案中面向 WebAssembly 的用法。开启 experiments.sourceImport[20] 后,你可以通过静态的 import source 或动态的 import.source() 导入 .wasm 模块。
与普通 WebAssembly 导入不同,source phase import 不会在导入时直接实例化 Wasm 模块,而是返回编译后的 WebAssembly.Module[21]。这使你可以自行控制实例化过程,例如使用不同的 imports 多次实例化同一个 Wasm 模块,或在多个 Web Worker 中复用同一个编译结果,避免重复编译成本。
// rspack.config.mjsexport default { experiments: { sourceImport: true, },};
// index.jsimport source wasmModule from './modul…