Rsbuild v0.6 发布#

April 10, 2024

Rsbuild v0.6 已与 Rspack v0.6 同步发布！

主要变更：

• 升级 Rspack v0.6
• 默认启用 error overlay
• 支持 Vue JSX HMR
• 全新的 transform 插件 API
• 默认端口调整为 3000

升级 Rspack v0.6#

Rsbuild 已将依赖的 Rspack 升级至 v0.6 版本，并适配了 Rspack v0.6 包含的 CSS Modules 不兼容更新。

在新版本中，Rspack 默认开启了新版 tree shaking 算法，使产物体积和产物稳定性得到显著提升。请参考 Rspack 0.6 发布公告 了解更多。

默认启用 error overlay#

从 Rsbuild v0.6 开始，dev.client.overlay 的默认值调整为 true。这意味着当出现编译错误时，Rsbuild 将默认弹出 error overlay 来展示错误信息：

如果你不需要此功能，可以将 dev.client.overlay 设置为 false 来禁用：

export default defineConfig({
  dev: {
    client: {
      overlay: false,
    },
  },
});

支持 Vue JSX HMR#

@rsbuild/plugin-vue-jsx 现已支持 JSX HMR，当你在 Vue 3 应用中修改 JSX 代码时，会自动触发模块热替换，并保留当前页面的状态。

该功能由社区贡献者 @liyincode 实现 ❤️，并且发布为独立的 babel-plugin-vue-jsx-hmr 包，以便在 Rsbuild 以外的项目中使用。

全新的 transform API#

Rsbuild 插件现已支持 transform API，这可以理解为 Rspack loader 的一个轻量化实现，它提供了简单易用的 API，并在底层自动调用 Rspack loader 进行代码转换。

在 Rsbuild 插件中，你可以通过 api.transform 快速实现代码转换功能，能够满足大部分常见场景，而无须学习 Rspack loader 的编写方法。

比如匹配以 .pug 为后缀的模块，并转换为 JavaScript 代码：

import pug from 'pug';

const pluginPug = () => ({
  name: 'my-pug-plugin',
  setup(api) {
    api.transform({ test: /\.pug$/ }, ({ code }) => {
      const templateCode = pug.compileClient(code, {});
      return `${templateCode}; module.exports = template;`;
    });
  },
});

对于一些复杂的代码转换场景，api.transform 可能无法满足，此时你可以使用 Rspack loader 进行实现。

默认端口调整为 3000#

Rsbuild 已将 server.port 的默认值从 8080 调整到 3000。

端口 3000 通常用于 web 开发领域，也是 create-react-app 等工具默认使用的端口。通过更改默认端口为 3000，可以避免在使用 8080 时可能遇到的端口冲突问题。

如果你需要使用 8080 端口，可以手动设置：

export default defineConfig({
  server: {
    port: 8080,
  },
});