Rspack 博客

Rspack 2.0 正式发布

Wed, 22 Apr 2026 16:00:01 GMT

2026 年 4 月 22 日

Rspack 2.0 正式发布

我们很高兴地宣布 Rspack 2.0 已正式发布！

回顾 1.x

在 2024 年 8 月发布 Rspack 1.0 时，我们设定了一个明确的阶段目标：在保持与 webpack API 和生态兼容的前提下，实现 10 倍的构建性能提升。

回顾 1.x 阶段，这一目标已经基本达成。Rspack 不仅实现了 webpack 的核心能力和插件 API，也在开发体验、产物优化以及现代语言特性支持等方面不断演进，陆续引入并完善了增量构建、按需编译、持久化缓存、常量内联、虚拟模块、Barrel 文件优化等新特性。

同时，Rspack 也正被越来越多的用户采用。与 1.0 发布时相比，Rspack 的周下载量已由 10 万增长至 500 万：

我们还围绕 Rspack 打造了 Rstack，一套统一的 JavaScript 工具链，包括 Rsbuild、Rslib、Rstest、Rspress、Rsdoctor 和 Rslint。这些工具面向不同场景，但都共享了同一个使命：让 Web 开发变得更加简洁、一致和高效。

Rspack 也在逐步融入更广泛的 JavaScript 生态，社区中许多优秀的工具、框架和平台已经提供对 Rspack 的支持，包括但不限于：Angular Rspack、Addfox、Docusaurus、Extension.js、ice.js、Lynx、Meteor、Modern.js、Next.js、Nuxt、Nx、Kmi、Re.Pack、Remotion、Shakapacker、Storybook、TanStack Router、Unplugin、Vize、xmcp、Zephyr。在此，我们衷心感谢所有支持 Rspack 的社区项目和团队。

迈向 2.0

JavaScript 生态在不断发展，Coding Agent 也正在改变软件研发范式。这促使我们重新思考：一个面向未来的打包工具应当如何演进。

Rspack 的目标不只是成为一个「更快的 webpack」。在 1.x 阶段，我们有意让 Rspack 的 API 和默认值与 webpack 5 保持一致，这一策略是为了帮助现有项目低成本迁移到 Rspack。但随着 JavaScript 模块规范和生态的发展，一些历史设计已不再适合作为当下的默认选择。

从 2.0 开始，在保持对 webpack 生态兼容的前提下，Rspack 将逐步引入更符合现代 JavaScript 开发的默认行为、API 设计和构建产物。这将是一个渐进的过程，我们会尽量避免在单个主版本中引入过多不兼容变更，同时也会提供迁移指南与 Agent Skills，将迁移成本控制在可接受范围内。

2.0 亮点

Rspack 2.0 主要带来以下更新：

性能提升
- 构建提速
- 精简默认依赖
产物优化
改进 ESM 支持
新特性

性能提升

构建提速

构建性能始终是 Rspack 的核心关注点之一。与 Rspack 1.7 相比，Rspack 2.0 的整体性能提升约 10%，相较 1.0 最多可提升 100%。

版本	生产构建（无缓存）	生产构建（有缓存）	热更新
Rspack 1.0	5.6 s	5.6 s	128 ms
Rspack 1.7	3.6 s	2.2 s	134 ms
Rspack 2.0	3.1 s	1.4 s	118 ms

数据来源：rspack-react-10k-benchmark

这些改进主要来自对核心架构的持续优化。我们针对关键性能路径重构了部分算法与数据结构，升级了部分过时依赖，并清理了不再使用的代码路径。

在开启持久化缓存的场景下，构建性能和内存占用得到了进一步改善：

现在 Rspack 支持对 SWC 压缩插件的结果进行缓存复用，在命中缓存时，构建性能提升约 50%
通过优化底层存储实现，在启用缓存时，内存占用下降了 20%+

精简默认依赖

Rspack 2.0 减少了默认安装的 npm 依赖数量：

@rspack/dev-server：依赖数量从 192 降至 1。
@rspack/core：依赖数量从 8 降至 1。
@rspack/cli：现在为零依赖。

在 Rspack 1.x 中，@rspack/dev-server 通过 webpack-dev-server 间接引入了较多依赖，这增加了安装体积，也加大了依赖管理的复杂度。为此，我们对它进行了重构，梳理并精简了功能和依赖，使安装体积减少超过 90%（从 15 MB 降至 1.4 MB）。

同时，@rspack/cli 也不再默认依赖 @rspack/dev-server，这意味着如果只使用 rspack build，将不再需要引入开发服务器相关依赖。

此外，我们还采用了以下方式来减少依赖：

将非核心依赖调整为可选依赖。例如 @module-federation/runtime-tools 现在仅在使用模块联邦插件时才需要手动安装。
使用更轻量的替代实现，例如以 connect-next 替代 Express。对于开发服务器而言，Connect 的中间件模型已经能够覆盖大多数场景，这也与 Rsbuild 的开发服务器实现保持一致。
将部分依赖打包进 npm 发布产物，由 Rspack 统一控制这些依赖及其子依赖的版本，避免依赖自动升级带来的潜在供应链风险。
优先使用 Node.js 20+ 内置的原生 API，例如用 styleText 替代 picocolors。

产物优化

静态分析增强

Rspack 2.0 在静态分析能力上进行了增强，使更多复杂代码模式纳入 tree shaking 的优化范围。一些过去难以分析的场景，现在也能参与导出级别的裁剪。

CommonJS require 解构赋值：Rspack 现在可以识别解构中实际使用到的导出成员，仅保留必要代码

const { bar } = require('./foo');

CommonJS require 成员访问与调用：Rspack 现在能继续向下分析对象的成员访问和调用，判断哪些导出被使用

const foo = require('./foo');

foo.bar;
foo.baz();

动态 import() 结果的内联成员访问与调用：对于这种直接在表达式中访问模块成员的写法，Rspack 同样可以识别使用到的导出，并进行裁剪

(await import('./foo')).bar;

编译器注解支持

Rspack 2.0 现在支持编译器注解，允许你使用 #__NO_SIDE_EFFECTS__ 将函数标记为无副作用。当该函数调用的返回值未被使用时，tree shaking 会自动移除未使用的代码。

例如，在下面的代码中，join 被标记为无副作用函数。当它的返回值没有被使用时，该调用会被安全移除。

utils.js

/*#__NO_SIDE_EFFECTS__*/
export function join(a, b) {
  return `${a}-${b}`;
}

index.js

import { join } from './utils';

join('btn', 'primary');

该功能仍处于实验阶段，目前需要通过 experiments.pureFunctions 启用，并将在后续版本中默认开启，查看指南了解更多。

对于无法直接修改源码的第三方模块，Rspack 还允许你通过 module.parser.javascript.pureFunctions 选项手动声明纯函数列表，以达到同样的效果。

rspack.config.mjs

export default {
  module: {
    parser: {
      javascript: {
        pureFunctions: ['myFunctionName'],
      },
    },
  },
};

Rspack 现在支持对模块联邦的共享依赖进行 tree shaking。它可以在导出级别裁剪共享依赖，移除未使用的部分，从而减小共享包的体积。

在 Rspack 1.x 中，只要依赖被声明为 shared，运行时通常需要加载完整包。即使只用到少量导出，也会引入全部内容。对于体积较大的共享库，这会带来显著的开销。

而 Rspack 2.0 支持在 shared 选项中开启 treeShaking。此时，ModuleFederationPlugin 会为共享依赖生成裁剪后的产物，运行时优先加载该结果；若无法命中，再回退到完整依赖，以保证行为一致。

例如：

rspack.config.mjs

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

export default {
  plugins: [
    new rspack.container.ModuleFederationPlugin({
      shared: {
        'lodash-es': {
          singleton: true,
          treeShaking: {
            mode: 'runtime-infer',
            usedExports: ['debounce'],
          },
        },
      },
    }),
  ],
};

查看共享依赖 tree shaking 指南了解更多。

改进 ESM 支持

纯 ESM 包

Rspack 的核心包现在以 pure ESM 包的形式发布，并移除了自身的 CommonJS 构建产物，这使模块加载方式更加统一，也更符合当前 Node.js 的主流实践。

本次变更涉及以下 npm 包：

在 Node.js 20 及以上版本中，运行时已原生支持通过 require(esm) 加载 ESM 模块。因此，对于大多数仍通过 JavaScript API 使用 Rspack 的项目而言，这一变更通常不会带来实际影响，也无需额外修改现有代码。

import.meta 支持

Rspack 2.0 改进了对 import.meta 的支持。

在 Rspack 1.x 中，为了兼容非 ESM 产物，Rspack 会在编译阶段解析 import.meta 并替换为对应的值。对于无法识别的 import.meta 属性，通常会直接替换为 undefined。

从 Rspack 2.0 开始，在生成 ESM 产物时，Rspack 默认会保留无法识别的 import.meta 属性，而不是在编译阶段将其替换。这使你可以使用一些自定义 import.meta 属性，也使其行为更符合 ESM 规范。

这一行为也可以通过 module.parser.javascript.importMeta 进行控制，例如：

rspack.config.mjs

export default {
  output: {
    module: true,
  },
  module: {
    parser: {
      javascript: {
        importMeta: 'preserve-unknown',
      },
    },
  },
};

此外，Rspack 2.0 还补充了对 import.meta.main、import.meta.filename 和 import.meta.dirname 的支持。

import defer 支持

import defer 是 JavaScript 中一项用于延后模块求值的能力，也已在 TypeScript 5.9 中得到支持。它允许你在导入模块时先完成加载，而不立即执行模块及其依赖，从而更好地控制代码加载和副作用发生的时机。

Rspack 从 1.6 开始支持 import defer * as foo from './foo' 语法。在 2.0 中，我们进一步补齐了对 import.defer() 的支持，使这项能力能够覆盖更多实际场景。

启用实验性开关：

rspack.config.mjs

export default {
  experiments: {
    deferImport: true,
  },
};

使用 import.defer() 来动态导入模块：

app.js

const file = Math.random() > 0.5 ? 'a.js' : 'b.js';

import.defer('./dir' + file);

改进 ESM 库构建

在构建 JavaScript 库时，ESM 输出的质量会直接影响下游工具的分析和优化效果。更纯净的 ESM 产物，通常也更有利于静态分析、代码分割和 tree shaking。

在 Rspack 2.0 中，你可以将 output.library.type 配置为 'modern-module'，以生成更适合库发布的 ESM 产物。

rspack.config.mjs

export default {
  output: {
    library: {
      type: 'modern-module',
    },
  },
};

相比面向普通 ESM 输出的 output.module 选项，modern-module 针对库构建场景做了专门优化。它基于 Rspack 1.x 中引入的实验性 rspack.experiments.EsmLibraryPlugin 演进而来，生成的产物更便于下游工具继续分析和处理。在代码分割场景下，它也能保持更清晰的 ESM 结构，并减少多入口构建中的重复代码。

此外，modern-module 还支持保留源码目录结构，详见 ESM 指南。

新特性

React Server Components 支持

React Server Components（RSC）正在成为 React 全栈框架中的一项重要基础能力。Rspack 2.0 也为此提供了实验性的底层构建支持，包括：

指令支持：支持 "use client" 声明，以及模块和函数级别的 "use server" 声明
编译期检查：在编译阶段识别违反 RSC 规范的 React API 调用，帮助在进入运行时前尽早发现问题
CSS 支持：在构建阶段收集服务端与客户端组件的样式，并在渲染时注入
HMR 支持：同时支持服务端组件和客户端组件的热更新

你可以通过以下两种方式使用这项能力：

使用 Rsbuild：我们通过 rsbuild-plugin-rsc 提供了开箱即用的 RSC 支持。
手动配置 Rspack：参考 React Server Components 文档以手动添加相关配置。

在生态支持方面，Modern.js 已基于 Rspack 提供 RSC 支持，详见 Modern.js RSC 文档。同时，Rspack 已支持 React Router 的 Data Mode，相关示例见 React Router 示例。

另外，我们也在与 TanStack 团队展开合作，计划在后续版本中提供对 TanStack Start 和 TanStack 的 RSC 的支持。TanStack Start 是一个基于 TanStack Router 构建的全栈框架，我们非常期待结合双方的能力，共同探索 RSC 在不同场景下的更多可能性。

`#/` 子路径别名导入

在模块解析方面，Rspack 2.0 支持 #/ 形式的子路径别名导入。这样一来，你可以直接使用 package.json 中的 imports 字段来组织包内路径映射，而不必额外维护一套独立的别名配置。

package.json

{
  "imports": {
    "#/*": "./src/*"
  }
}

src/index.js

import main from '#/main.ts';

简化目标环境配置

在 Rspack 1.x 中，顶层的 target 选项不会影响 loader 或压缩工具的转换目标，因此你通常还需要在 loader 或压缩插件中分别配置目标环境。这带来了额外的配置成本，同一份目标环境信息需要在多个位置重复声明。

Rspack 2.0 对此进行了改进，内置的 loaders 和压缩插件会默认解析顶层的 target 配置，并据此推断各自需要的目标环境设置。多数情况下，你只需要在顶层声明一次目标环境，就能让 JavaScript 代码转换、CSS 转换和代码压缩保持一致。

rspack.config.mjs

export default {
  target: 'browserslist: Chrome >= 100',
  module: {
    rules: [
      {
        test: /\.js$/,
        use: [
          {
            loader: 'builtin:swc-loader',
            options: {
              env: { targets: 'Chrome >= 100' },
            },
          },
        ],
      },
    ],
  },
  optimization: {
    minimizer: [
      new rspack.SwcJsMinimizerRspackPlugin(),
      new rspack.LightningCssMinimizerRspackPlugin({
        minimizerOptions: { targets: 'Chrome >= 100' },
      }),
    ],
  },
};

查看 target - 目标环境继承了解更多。

简化 swc-loader 配置

在以往的配置中，如果希望 builtin:swc-loader 同时处理 .js、.jsx、.ts、.tsx 等文件，需要根据文件类型显式指定 jsc.parser 中的 syntax、jsx、tsx 等选项，以确保 SWC 能以正确的语义解析代码，例如判断 < 应被解析为 JSX 语法还是 TypeScript 泛型。

这带来了一定的配置复杂度。为了让 SWC 正确解析不同后缀的文件，通常需要定义多条 rules，导致配置变得冗长，不利于维护。

为了解决这一问题，Rspack 2.0 在内置的 swc-loader 中引入了 detectSyntax 选项。启用 detectSyntax: 'auto' 后，loader 会根据文件扩展名自动推断 syntax、jsx、tsx 等 parser 选项。通过一条规则即可覆盖不同的文件类型，使配置更清晰。

rspack.config.mjs

export default {
  module: {
    rules: [
      {
        test: /\.(?:js|mjs|jsx|ts|tsx)$/,
        use: {
          loader: 'builtin:swc-loader',
          options: {
            detectSyntax: 'auto',
          },
        },
      },
    ],
  },
};

支持控制 CSS 导入

Rspack 2.0 的 CSS 解析器提供了 resolveImport 选项，它用于控制构建时是否解析并内联 @import。

默认情况下，Rspack 会解析 @import，并将导入的内容直接合并到当前文件中。你也可以将 resolveImport 设为 false，保留原始的 @import，交由浏览器或下游工具处理。

resolveImport 还支持传入函数，用来按需决定每一条 @import 是否需要内联。例如，你可以只内联文件名包含 style.css 的导入，其他导入则保留原样：

rspack.config.mjs

export default {
  module: {
    parser: {
      'css/auto': {
        resolveImport: ({ url }) => url.includes('style.css'),
      },
    },
  },
};

使用哈希作为模块 ID

Rspack 2.0 为 optimization.moduleIds 新增了 hashed 选项。启用后，Rspack 会基于模块路径生成较短且稳定的哈希值，并将其用作模块 ID。

这适用于希望在保持模块 ID 稳定性的同时，进一步缩短模块 ID 长度的场景。对于模块数量较多的大型应用，这在某些情况下也有助于减少产物中模块 ID 占用的体积。

rspack.config.mjs

export default {
  optimization: {
    moduleIds: 'hashed',
  },
};

代码分割改进

Rspack 2.0 现在支持 splitChunks.enforceSizeThreshold 选项，用于为代码分割设置一个强制生效的体积阈值。

默认情况下，splitChunks 中的请求数限制选项，例如 maxAsyncRequests 和 maxInitialRequests，可能会阻止较大的 chunk 继续拆分。在启用 enforceSizeThreshold 后，只要模块组的体积超过设定阈值，Rspack 就会忽略这些限制并进行强制拆分。

在生产模式下，Rspack 默认会为所有模块类型设置 50000 字节的 enforceSizeThreshold，其他模式下默认值为 30000 字节。你也可以根据需要自行调整这个选项：

rspack.config.mjs

export default {
  optimization: {
    splitChunks: {
      // 对所有模块类型生效
      enforceSizeThreshold: 50000,
      // 也可以按模块类型分别配置
      // enforceSizeThreshold: { javascript: 50000, css: 30000 },
    },
  },
};

该选项也支持在 cache group 中单独配置，以便为特定的 cache group 指定不同的值。

尝试 2.0

创建新项目

如果你是首次使用 Rspack，推荐直接创建 Rsbuild 项目，它是一个由 Rspack 驱动、开箱即用的构建工具：

npm create rsbuild@latest

查看快速上手了解更多。

从 v1 升级

Rspack 2.0 包含一些不兼容变更。对于现有项目，我们提供了升级指南，其中包含从 v1 升级到 v2 的所有不兼容变更，以及对应的迁移方式。

如果你正在使用支持 Skills 的 Coding Agent，可以安装下面的 Skill，让 Agent 协助完成迁移；这种方式通常比手动升级更高效。

npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade

展望未来

Rspack 2.0 标志着一个新的演进阶段。相比 1.0，我们已经在性能、API 设计和产物形态上做出了一系列改进。接下来，我们会继续从多个方向推进 Rspack 的演进，包括产物优化、Agent 支持和工具链协同等：

产物优化：Rspack 的目标不仅是更快地完成构建，也是在保证行为稳定的前提下生成质量更高的产物。我们会继续改进 tree shaking、代码分割和静态分析等基础能力，探索结合静态类型信息进行优化分析，并提供更细粒度的代码拆分与优化选项。
Agent 友好：随着 Coding Agent 逐渐成为开发工具的重要使用者，我们也会在设计中更多考虑这类场景，让 Agent 更容易理解和处理构建问题。例如，通过 CLI 向 Agent 提供更丰富的调试信息、性能数据和其他上下文，帮助它更准确地分析问题并参与问题排查和性能优化。
工具链协同：在实际项目中，耗时往往不只来自打包本身，测试、类型检查和代码检查等环节同样会带来明显开销。我们会继续推进 Rstack 工具链的协同演进，并与 typescript-go 结合。例如，Rslint 已支持 rslint --type-check，可同时执行代码检查和类型检查。后续我们也会在 ts-checker-rspack-plugin 中支持 typescript-go。

查看 Rspack 路线图了解更多。

常见问题

Rspack 2.0 还兼容 webpack 吗？

会。进入 2.0 阶段后，Rspack 仍然会把与 webpack 生态的兼容性作为重要目标。

随着 JavaScript 标准的发展，Rspack 也会更积极地引入更合理的默认行为和 API 设计，这会是一个渐进的过程。

1.x 版本还会继续维护吗？

会。2.0 发布后，对于 1.x 版本，我们仍会在一段时间内继续提供维护支持，例如关键问题修复和迁移支持。但后续的新特性和优化会优先在 2.x 上实现，因此我们建议尽快升级至 2.x。

Rspack 生态什么时候升级到 2.0？

Rsbuild 2.0 已经与 Rspack 2.0 同步发布，查看 Rsbuild 2.0 博客了解更多。

Rslib、Rstest 和 Rspress 也会在随后升级到 Rspack 2.0 正式版。与此同时，我们也会持续协助社区中的框架和工具完成对 Rspack 2.0 的升级与适配。

致谢

感谢所有 Rspack 的用户、贡献者和合作伙伴。每一条反馈和参与，都在推动 Rspack 生态的发展。我们也希望 Rspack 能为 JavaScript 生态的发展持续贡献力量。

感谢社区中各个打包工具的开发团队，包括 esbuild、Parcel、Rollup、Rolldown、Turbopack 和 webpack。正是因为这些项目在不同方向上的持续探索，许多想法才得以相互启发，并最终得以实现。

Rspack 1.7 发布公告

Wed, 31 Dec 2025 16:00:00 GMT

2025 年 12 月 31 日

Rspack 1.7 发布公告

我们很高兴地宣布 Rspack 1.7 已正式发布！这是 Rspack 1.x 的最后一个 minor 版本，主要聚焦于现有功能的稳定性改进。接下来，我们将很快带来 Rspack 2.0。

值得关注的变更如下：

新特性
Rstack 进展

新特性

SWC 插件兼容性提升

在过去的版本中，SWC Wasm 插件的升级成本一直较高。这是由于 SWC 的 AST 结构会随着版本演进发生变化，已有插件在 SWC 升级后可能无法继续工作，插件作者需要进行适配，插件使用者也需要同步升级依赖，这在一定程度上影响了项目的稳定性和升级体验。

为缓解这一问题，我们向 SWC 社区贡献了一系列兼容性改进，包括：

使用自描述式的 cbor 序列化方案，取代原先对版本敏感的 rkyv，使 Wasm 插件能更好地适应 AST 结构的变更
为 AST 中的枚举类型引入 Unknown 变体，从而在遇到新字段或新节点时提升容错能力

在 Rspack 1.7 中，我们升级了使用的 SWC 版本并支持了上述方案。在此之后，多数场景下 SWC 的升级将不会影响基于旧版本 SWC 构建的插件的正常使用。

目前，该方案已在大部分流行的 SWC Wasm 插件中完成接入。如果你是 SWC Wasm 插件作者，可参考官方指南，接入该方案，以降低后续版本演进中的维护成本。

支持 Import bytes

Rspack 现已原生支持 Import Bytes 提案，可以将静态资源作为 Uint8Array 导入，并通过 TextDecoder 解码。

// 静态导入
import fileBytes from './file.bin' with { type: 'bytes' };
const decoder = new TextDecoder('utf-8');
const text = decoder.decode(fileBytes);

// 动态导入
const module = await import('./file.bin', { with: { type: 'bytes' } });
const decoder = new TextDecoder('utf-8');
const text = decoder.decode(module.default);

Lazy compilation

在 Rspack 1.5 中，我们完成了 Lazy Compilation 特性的稳定化，并在 Rsbuild 中默认对动态导入的模块启用了按需编译。

从 Rspack 1.7 开始，Rspack CLI 在构建 web 应用时也将默认对动态导入的模块启用按需编译。这一改进可以减少首次构建的模块数量，从而加快开发服务器的启动速度。

rspack.config.mjs

export default {
  // 当前默认配置
  lazyCompilation: {
    imports: true,
    entries: false,
  },
};

如果你有特殊需求，例如需要调试完整构建的产物，或分析完整的模块图，可以通过将 lazyCompilation 设置为 false 来显式关闭该功能。

实验特性稳定化

在 Rspack 1.7 中，我们稳定化了多项实验性特性。以下能力已完成生产验证并进入稳定阶段，相关实验开关也随之废弃，或调整为默认行为：

常量内联优化：该优化已正式稳定，并在生产构建中默认启用。
- 原有的 experiments.inlineConst 选项已废弃
- 如需关闭该行为，可通过 optimization.inlineExports 来控制
TypeScript enum 内联优化：该优化已正式稳定。
- 原有的 experiments.inlineEnum 选项已废弃
- 使用 collectTypeScriptInfo.exportedEnum 控制是否收集导出的 enum 信息
- 使用 optimization.inlineExports 来控制是否内联 enum
类型重导出检查：该优化已正式稳定。
- 原有的 experiments.typeReexportsPresence 选项已废弃

参考升级指南了解如何调整相关配置。

Rstack 进展

Rsbuild 1.7

Error overlay 改进

Rsbuild 的 error overlay 现在支持显示运行时错误。当应用在运行过程中抛出异常时，错误会直接渲染到 overlay 上，帮助你更快发现并定位问题。

该功能默认关闭，可通过 dev.client.overlay.runtime 选项按需开启：

rsbuild.config.ts

export default {
  dev: {
    client: {
      overlay: {
        runtime: true,
      },
    },
  },
};

产物体积对比

Rsbuild 现在支持输出产物体积对比，用来查看构建结果是否发生了体积变化。

开启 performance.printFileSize.diff 选项后，Rsbuild 构建完成时会记录一份产物体积快照，后续构建会自动与上一次结果对比，并在日志中直接展示体积变化。你可以清楚地看到每个文件是变大还是变小，以及整体体积的增减情况，适合在日常开发和性能回归中快速发现体积变化。

rsbuild.config.ts

export default {
  performance: {
    printFileSize: {
      diff: true,
    },
  },
};

create-rsbuild 改进

create-rsbuild 现在包含了更多开箱即用的工具。

在创建 Rsbuild 项目时，你现在可以选择自动集成 Rstest 作为测试框架，或启用 Storybook 用于 UI 组件的开发与调试。相关依赖和配置都会在初始化时一次性完成，减少重复的手动配置成本。

◆  Select additional tools (Use  to select,  to continue)
│  ◼ Rstest - testing
│  ◻ Biome - linting & formatting
│  ◻ ESLint - linting
│  ◻ Prettier - formatting
│  ◻ Storybook - component development
└

Rsdoctor 1.4

新的 Treemap 视图

Rsdoctor 1.4 对原有的 Treemap 视图进行了改进。新的交互设计可以帮助你更直观地分析 bundle 的整体构成，以及各类资源和模块的体积占比。

在该视图中，你可以通过搜索快速定位到具体的模块或资源。点击某个模块或资源后，视图会自动聚焦并放大对应区域。双击模块还可以展开其依赖链路，逐层查看模块之间的引用关系，从而更清晰地分析体积来源。

Rslib 0.19

ESM 产物稳定化

在此前的版本中，Rslib 通过实验性配置 experiments.advancedEsm 来启用 Rspack 的新版 ESM 库产物，用于提升 ESM 产物的整体质量。经过多个版本的验证与打磨，该能力现已完成稳定化。

自 Rslib 0.19 起，Rslib 的 bundle 模式将默认启用该特性。开发者无需进行任何额外配置，即可直接获得对静态分析更友好、并完整支持代码分割的 ESM 产物。

JavaScript API

Rslib 0.19 引入了 JavaScript API，使开发者可以在 JavaScript 代码中以编程方式直接调用 Rslib 的构建能力。

下面是一个基础示例：

import { createRslib } from '@rslib/core';

// 创建 Rslib 实例
const rslib = await createRslib();
// 构建生产环境输出
await rslib.build();

更多使用方式请参考 API 文档。

Rstest 0.7

配置适配器

Rstest 0.7 引入了 extends 选项和适配器机制，用于直接复用现有的工具或框架配置。适配器是一个配置转换函数，可以将其他工具的配置转换为 Rstest 的配置，从而降低 Rstest 的集成成本。

例如，在一个使用 Rslib 的库项目中，通过 @rstest/adapter-rslib 适配器，你可以直接复用已有的 Rslib 配置：

rstest.config.ts

import { defineConfig } from '@rstest/core';
import { withRslibConfig } from '@rstest/adapter-rslib';

export default defineConfig({
  // 自动读取 rslib.config.ts 并转换为 Rstest 配置
  extends: withRslibConfig(),
  // 其他测试配置
  coverage: {
    // ...
  },
});

适配器则负责将不同工具的配置转换为 Rstest 的配置（如 define、alias 等），而 extends 则负责将转换后的配置与 Rstest 的配置进行合并。通过二者的配合，任何基于 Rspack 的工具或框架，都可以以最小成本与 Rstest 集成。

目前 @rstest/adapter-rslib 适配器已正式发布，后续我们还将推出更多适配器，以对接 Rstack 的各个工具。你也可以参考 Rstest - 适配器来编写自定义的适配器。

测试反馈优化

Rstest 针对本地开发与调试场景进行了多项体验优化，让测试反馈更加直观：

更早发现卡住的测试: Rstest 现已支持在本地运行时标记长时间未完成的测试用例。当测试过程变慢时，你可以直接看到是哪个用例正在执行、可能已经卡住，而不再只能盯着终端等待整个测试超时结束。
更清晰的超时失败反馈: 当测试因超时失败时，Rstest 现在会在错误信息中展示已执行的断言数量。这能帮助你快速判断测试是否已经部分执行，或是卡在了某个异步逻辑中，从而更快定位问题。

Rspress 2.0 RC

SSG-MD 特性

在基于 React 动态渲染的前端框架中，往往存在静态信息难以提取的问题，Rspress 也遇到了相同的问题。Rspress 允许用户通过 MDX 片段、React 组件、Hooks 以及 TSX 路由等动态特性来增强文档表现力。但这些动态内容在转换为 Markdown 文本时会面临以下问题：

直接将 MDX 输入给 AI 会包含大量代码语法噪音，并丢失 React 组件内容
将 SSG 生成的 HTML 转为 Markdown 往往效果不佳，信息质量难以保证

为了解决这个问题，Rspress 2.0 引入了 SSG-MD 特性。这是一个全新的功能，见名知意，与静态站点生成（SSG）唯一的不同在于它将你的页面渲染为 Markdown 文件，而非 HTML 文件，并生成 llms.txt 及 llms-full.txt 相关文件。相比与将 HTML 转化为 Markdown 等传统方式，SSG-MD 在渲染期间拥有更好的信息源，比如 React 虚拟 DOM，因此拥有更好的静态信息质量和灵活性。

启用方式非常简单：

rspress.config.ts

import { defineConfig } from '@rspress/core';

export default defineConfig({
  llms: true,
});

构建后将生成如下结构：

doc_build
├── llms.txt          # 摘要版，包含关键文档索引
├── llms-full.txt     # 完整版，包含所有文档内容
├── guide
│   └── start
│       └── introduction.md
└── ...

对于自定义组件，你可以通过环境变量来控制其在 SSG-MD 模式下的渲染行为：

export function Tab({ label }: { label: string }) {
  if (import.meta.env.SSG_MD) {
    // SSG-MD 模式下输出纯文本描述
    return <>{`**Tab: ${label}**`};
  }
  // 正常渲染交互式组件
  return <div className="tab">{label}div>;
}

这样既保证了文档的交互体验，也能帮助 AI 理解组件的语义信息。

详见 SSG-MD 使用指南

升级指南

升级 SWC 插件

如果你的项目中使用了 SWC Wasm 插件（如 @swc/plugin-emotion 等），请升级插件至兼容 swc_core@54 及以上版本，否则可能因版本不兼容导致构建失败或运行异常。

详情请查阅：常见问题 - SWC 插件版本不匹配。

移除废弃配置

以下实验性选项已废弃，可以直接移除：

rspack.config.mjs

export default {
  experiments: {
    inlineConst: true,
    inlineEnum: true,
    typeReexportsPresence: true,
  },
};

调整 builtin:swc-loader 中的 collectTypeScriptInfo 选项位置，移除 rspackExperiments 层级：

rspack.config.mjs

export default {
  module: {
    rules: [
      {
        test: /\.ts$/,
        loader: 'builtin:swc-loader',
        options: {
          rspackExperiments: {
            collectTypeScriptInfo: {
              exportedEnum: true,
              typeExports: true,
            },
          },
        },
      },
    ],
  },
};

Rspack 1.6 发布公告

Thu, 30 Oct 2025 16:00:00 GMT

2025 年 10 月 30 日

Rspack 1.6 发布公告

我们很高兴地宣布 Rspack 1.6 已正式发布！

值得关注的变更如下：

新特性
Rstack 进展
生态系统
- next-rspack

新功能

增强 Tree shaking

Rspack 1.6 增强了对动态导入 tree shaking 的支持。在此前的版本中，Rspack 仅能对动态导入中的解构赋值进行 tree shaking，而其他形式的导入则不会被分析。

现在，Rspack 为动态导入引入了更全面的静态分析，能够识别并处理多种使用模式，从而精准地移除未被使用的导出内容，进一步减小最终打包产物的体积。

// Rspack 1.5 - 仅支持分析解构赋值
const { value } = await import('./module');
console.log(value);

// Rspack 1.6 - 支持分析以下情况
// Case 1
const mod = await import('./module');
const { value } = mod;
console.log(value);

// Case 2
const mod = await import('./module');
console.log(mod.value);

// Case 3
import('./module').then(({ value }) => {
  console.log(value);
});

// Case 4
import('./module').then((mod) => {
  const { value } = mod;
  console.log(value);
});

// Case 5
import('./module').then((mod) => {
  console.log(mod.value);
});

支持 import defer

Rspack 现已支持 import defer 语法。

import defer 是 JavaScript 中一个新特性，也已经在 TypeScript 5.9 中得到支持，它允许你在导入模块时不立即执行模块及其依赖，从而更好地控制代码的加载和副作用发生的时机。

import defer * as foo from './foo';

你可以通过 experiments.deferImport 启用此特性：

rspack.config.mjs

export default {
  experiments: {
    deferImport: true,
  },
};

目前 Rspack 仅支持 import defer 语法，import.defer() 的函数形式将在后续版本中实现。

优化 ESM 产物

如何优化 ESM 产物一直是 Rspack 面临的难题之一。过去我们通过 module concatenation 来优化 ESM 输出，但这种方式存在一些局限：

输出不够纯净：生成文件中包含了 Rspack 运行时代码
可能出错：某些模块无法被正确合并，可能导致产物行为异常
有限的代码分割支持：代码分割后的产物会变得复杂，难以进行静态分析和优化

为了彻底解决这些问题，我们引入了实验性的 EsmLibraryPlugin 插件，它专为构建 ESM 库设计，让生成的代码更加简洁和高效：

完全接管打包过程：在编译阶段完成模块连接，不再依赖 Rspack 的运行时代码
支持代码分割：分割后的代码可被静态分析和 tree shaking 友好

下图展示了使用该插件前后的代码分割产物对比：左侧为之前的产物，右侧为使用 EsmLibraryPlugin 后的输出：

目前，EsmLibraryPlugin 已基本开发完成，并正在集成至 Rslib 中，以提供开箱即用的体验。

你也可以通过以下配置手动启用它：

rspack.config.mjs

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

export default {
  plugins: [new rspack.experiments.EsmLibraryPlugin()],
  optimization: {
    // Recommended to enable; otherwise, consumers must import runtime code from the entry.
    runtimeChunk: true,
  },
};

此外，我们还提供了 preserveModules 选项，可让输出结构与源码目录保持一致：

rspack.config.mjs

import path from 'node:path';

export default {
  plugins: [
    new rspack.experiments.EsmLibraryPlugin({
      preserveModules: path.resolve(import.meta.dirname, './src'),
    }),
  ],
};

默认启用 barrel 优化

在 Rspack 1.5 中，我们引入了实验性的 lazyBarrel 优化功能，专门用于提升 barrel 文件（桶文件）的构建性能。经过一段时间的生产环境实践和用户反馈收集，我们确认 lazyBarrel 功能已经达到稳定状态，因此在 Rspack 1.6 中将其设为默认启用。

Info

什么是 barrel 文件？ Barrel 文件是指那些主要用于重新导出其他模块内容的文件，通常用于简化导入路径和提供统一的 API 入口。

layers 特性稳定

layer 是一种用于对模块进行分层管理的特性，可以用于 React Server Components 等进阶场景。通过为模块指定不同的 layer，你可以更灵活地控制它们的构建行为，例如：

将不同 layer 的模块编译到不同的目标环境
将它们输出到不同的产物目录中

从 Rspack 1.6 开始，layer 特性已经足够稳定，因此我们废弃了原先的实验性开关 experiments.layers。现在，你可以直接使用 layer 特性，不再需要实验性开关。

想了解更多 layer 的细节和使用方式，可以阅读我们新增的 layer 指南。

保留 JSX 语法

Rspack 现在支持在产物中保留 JSX 语法。当启用相关选项时，Rspack 只会对 JSX 进行语法分析，而不会将其转换为 JavaScript。

这一特性在构建一些使用 JSX 的库时尤其实用。例如，在使用 Rslib 构建组件库时，可以选择保留 JSX 原样输出，由消费端在使用阶段再完成 JSX 转换。

rspack.config.mjs

export default {
  module: {
    parser: {
      javascript: {
        jsx: true, // Enable JSX parsing
      },
    },
    rules: [
      {
        test: /\.jsx?$/,
        use: {
          loader: 'builtin:swc-loader',
          options: {
            jsc: {
              parser: { jsx: true },
              transform: {
                // Preserve JSX syntax
                react: { runtime: 'preserve' },
              },
            },
          },
        },
      },
    ],
  },
};

提取 source map

Rspack 现在支持通过 rules[].extractSourceMap 从文件中提取现有的源码映射数据（从它们的 //# sourceMappingURL 注释中）。这个功能对于保留第三方库提供的源码映射特别有用，确保即使在这些库被打包或转换时，调试信息仍然保持准确。

这个功能可以作为 source-map-loader 的内置替代方案，提供了更好的性能和与构建过程更紧密的集成。

rspack.config.mjs

export default {
  module: {
    rules: [
      {
        test: /\.m?js$/,
        extractSourceMap: true,
      },
    ],
  },
};

性能提升

Rspack 1.6 带来了多项性能优化，相较于 Rspack 1.5.0，性能提升如下：

CLI 启动速度提升约 50 ms
构建 10000 个 React 组件的速度提升 11%
构建多个 UI 组件库的速度提升 31%（得益于默认启用的 barrel 文件优化）

数据来源：Rspack benchmark

Rstack 进展

Rstack 是一个以 Rspack 为核心的 JavaScript 统一工具链，具有优秀的性能和一致的架构。

Rsbuild 1.6

转发浏览器日志

Rsbuild 现在会自动将浏览器中的错误日志转发到终端，帮助你在开发过程中便捷地查看运行时报错，这也使 Coding Agents 能够从终端日志中获取更完整的上下文，从而更好地分析和定位错误。

如果你不需要该功能，可以将 dev.browserLogs 设置为 false 来禁用它：

rsbuild.config.ts

export default {
  dev: {
    browserLogs: false,
  },
};

构建 ESM 应用

Rsbuild 现在支持为 Web 应用构建 ES Modules 格式产物，只需启用 output.module: true 即可：

rsbuild.config.ts

export default {
  output: {
    module: true,
  },
};

启用后，Rsbuild 将不再默认生成 IIFE 格式的脚本，而是输出标准的 ESM 格式，并自动将生成的

Rspack 博客

Rspack 2.0 正式发布

#Rspack 2.0 正式发布

#回顾 1.x

#迈向 2.0

#2.0 亮点

#性能提升

#构建提速

#精简默认依赖

#产物优化

#静态分析增强

#编译器注解支持

#模块联邦 tree shaking

#改进 ESM 支持

#纯 ESM 包

#import.meta 支持

#import defer 支持

#改进 ESM 库构建

#新特性

#React Server Components 支持

##/ 子路径别名导入

#简化目标环境配置

#简化 swc-loader 配置

#支持控制 CSS 导入

#使用哈希作为模块 ID

#代码分割改进

#尝试 2.0

#创建新项目

#从 v1 升级

#展望未来

#常见问题

#Rspack 2.0 还兼容 webpack 吗？

#1.x 版本还会继续维护吗？

#Rspack 生态什么时候升级到 2.0？

#致谢

Rspack 1.7 发布公告

#Rspack 1.7 发布公告

#新特性

#SWC 插件兼容性提升

#支持 Import bytes

#Lazy compilation

#实验特性稳定化

#Rstack 进展

#Rsbuild 1.7

#Error overlay 改进

#产物体积对比

#create-rsbuild 改进

#Rsdoctor 1.4

#新的 Treemap 视图

#Rslib 0.19

#ESM 产物稳定化

#JavaScript API

#Rstest 0.7

#配置适配器

#测试反馈优化

#Rspress 2.0 RC

#SSG-MD 特性

#升级指南

#升级 SWC 插件

#移除废弃配置

Rspack 1.6 发布公告

#Rspack 1.6 发布公告

#新功能

#增强 Tree shaking

#支持 import defer

#优化 ESM 产物

#默认启用 barrel 优化

#layers 特性稳定

#保留 JSX 语法

#提取 source map

#性能提升

#Rstack 进展

#Rsbuild 1.6

#转发浏览器日志

#构建 ESM 应用

Rspack 2.0 正式发布

回顾 1.x

迈向 2.0

2.0 亮点

性能提升

构建提速

精简默认依赖

产物优化

静态分析增强

编译器注解支持

模块联邦 tree shaking

改进 ESM 支持

纯 ESM 包

import.meta 支持

import defer 支持

改进 ESM 库构建

新特性

React Server Components 支持

`#/` 子路径别名导入

简化目标环境配置

简化 swc-loader 配置

支持控制 CSS 导入

使用哈希作为模块 ID

代码分割改进

尝试 2.0

创建新项目

从 v1 升级

展望未来

常见问题

Rspack 2.0 还兼容 webpack 吗？

1.x 版本还会继续维护吗？

Rspack 生态什么时候升级到 2.0？

致谢

Rspack 1.7 发布公告

新特性

SWC 插件兼容性提升

支持 Import bytes

Lazy compilation

实验特性稳定化

Rstack 进展

Rsbuild 1.7

Error overlay 改进

产物体积对比

create-rsbuild 改进

Rsdoctor 1.4

新的 Treemap 视图

Rslib 0.19

ESM 产物稳定化

JavaScript API

Rstest 0.7

配置适配器

测试反馈优化

Rspress 2.0 RC

SSG-MD 特性

升级指南

升级 SWC 插件

移除废弃配置

Rspack 1.6 发布公告

新功能

增强 Tree shaking

支持 import defer

优化 ESM 产物

默认启用 barrel 优化

layers 特性稳定

保留 JSX 语法

提取 source map

性能提升

Rstack 进展

Rsbuild 1.6

转发浏览器日志

构建 ESM 应用