Rspack 博客

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 解码。

// 静态导入
 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 应用时也将默认对动态导入的模块启用按需编译。这一改进可以减少首次构建的模块数量，从而加快开发服务器的启动速度。

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 选项按需开启：

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

产物体积对比

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

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

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 的构建能力。

下面是一个基础示例：



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

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

Rstest 0.7

配置适配器

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

例如，在一个使用 Rslib 的库项目中，通过 @rstest/adapter-rslib 适配器，你可以直接复用已有的 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，因此拥有更好的静态信息质量和灵活性。

启用方式非常简单：



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 {label};
}

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

详见 SSG-MD 使用指南

升级指南

升级 SWC 插件

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

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

移除废弃配置

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

export default {
  // [!code --]
  experiments: {
    // [!code --]
    inlineConst: true,
    // [!code --]
    inlineEnum: true,
    // [!code --]
    typeReexportsPresence: true,
  },
};

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

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

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 中得到支持，它允许你在导入模块时不立即执行模块及其依赖，从而更好地控制代码的加载和副作用发生的时机。

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

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 中，以提供开箱即用的体验。

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



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

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



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 转换。

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 的内置替代方案，提供了更好的性能和与构建过程更紧密的集成。

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 来禁用它：

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

构建 ESM 应用

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

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

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

Rspack 博客

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 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 应用