基于 Rust 的高性能 Web 构建工具。rspack 主要适配 webpack 生态，对于绝大多数 webpack 工具库都是支持的。
- 启动速度快；增量热更新快。
- 兼容 webpack 生态；内置了 ts、jsx、css、css modules 等开箱即用。
- 生产优化，tree shaking、代码压缩。
rspack-vue3 代码仓库
基本使用
创建项目rspack-vue3,安装@rspack/cli
$> npm init -y
$> npm install -D @rspack/cli
通过rspack.config.js文件来配置编译打包项,在跟项目中创建文件rspack.config.js。entry编译入口指向src/index.js;output配置构建输出
const path = require("path");module.exports = {entry: {main: "./src/index.js",},output: {filename: "main.js",path: path.resolve(__dirname, "dist"),},
};
在src/index.js文件中定义渲染函数并调用。在package.json增加脚本执行命令"build": "rspack build"
// 渲染函数
const render = () => {document.getElementById("app").innerHTML = "hello world";
};render();
执行构建，npm run build编译输出，可以看到dist目录的输出。在 dist 目录中新建index.html引入编译文件
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>Document</title></head><body><div id="app"></div></body><script src="./main.js"></script>
</html>
在浏览器中访问文件index.html，可以看到正常展示。
在package.json增加脚本执行命令"dev": "rspack serve"用于开发环境。rspack 内置了对 html 的支持，就无须我们手动创建配置 index.html 了。
创建 html 模板文件public/index.html,配置rspack.config.js并指向 html 文件
const path = require("path");module.exports = {// ...builtins: {html: [{ template: path.resolve(__dirname, "public/index.html") }],},
};
再次执行构建，可以看到自动在 dist 目录下生成了index.html
更新
@rspack/cli版本,修改了使用方式，查看后面的章节说明
配置对vue3的支持
安装vue、 vue-loader，vue-loader 版本必须>=17.2.2
&> npm i vue vue-loader
修改配置rspack.config.js，增加对 vue 单文件组件的解析
// plugins
const { VueLoaderPlugin } = require("vue-loader");module.exports = {//...plugins: [new VueLoaderPlugin()],module: {rules: [{test: /\.vue$/,loader: "vue-loader",options: {experimentalInlineMatchResource: true,},},],},
};
创建src/App.vue文件，并修改src/index.js入口文件，按照 vue 的使用方式引入组件、创建实例、挂载；
import { createApp } from "vue";import App from "./App.vue";// 创建实例
const app = createApp(App);app.mount("#app");
// 渲染函数
// const render = () => {
// document.getElementById("app").innerHTML = App;
// };// render();
配置less-loader
rspack 内置 css 模块的编译，对于 css 预处理器，只需安装后配置好。
$> npm i less-loader
修改配置，增加对 less 的解析。调整App.vuestyle 样式，嵌套书写 less 样式。
module.exports = {// ...module: {rules: [// ...{test: /\.less$/,loader: "less-loader",type: "css",},],},
};
如果不希望生成 css 文件，将 css 样式内联到 js 中，可以配置css-loader\vue-style-loader
$> npm i css-loader vue-style-loader -D
修改配置,npm run build可以看到没有额外的 css 文件生成。这里面有一个type: "javascript/auto"配置，它的作用是标记了资源的类型，而 rspack 根据类型有内置的处理方式。
当使用了css-loader\vue-style-loader后，就不需要原生的 css 支持，关闭配置experiments.css:false。会发生冲突。
module.exports = {// ...module: {rules: [// ...{test: /\.less$/,use: ["vue-style-loader", "css-loader", "less-loader"],type: "javascript/auto",},],},experiments: {css: false,},
};
支持JSX
酷爱使用的 jsx 必须要配置上，由于 rspack 对预 webpack 插件的兼容，大多数 webpack 的插件可用。
安装babel-loader \ @babel/core \ @vue/babel-plugin-jsx
$> npm i babel-loader @babel/core @vue/babel-plugin-jsx -D
修改配置，添加对 jsx 文件的解析。新建文件src/views/index.jsx创建 vue 组件，然后引入到App.vue中使用渲染。
module.exports = {// ...module: {rules: [// ...{test: /\.jsx$/,use: [{loader: "babel-loader",options: {plugins: ["@vue/babel-plugin-jsx"],},},],},],},
};
组件文件代码可以查看仓库
其他配置项
安装其他依赖库vuex/vue-router/element-plus
$> npm i vuex vue-router element-plus dayjs axios element-plus
这些都是 vue 的配套设施，这里不再多写了，每个项目里配置都差不多。
还有代码规范、提交规范等
$> npm i husky eslint eslint-plugin-vue eslint-config-prettier @commitlint/cli @commitlint/config-conventional -D
配置好之后，就可以创建项目去开发业务系统了。😄
全量导入element-plus样式时，编译报错
因为之前在配置.vue文件样式时增加了配置 experiments: { css: false },关闭了默认的 css 样式处理，需要手动增加 rules 配置来处理
安装style-loader,增加配置处理.css文件的处理。
{module: {rules: [{test: /\.css$/i,use: ["style-loader", "css-loader"],},];}
}
也可以使用vue-style-loader替代style-loader，都是解决项目加载 css 样式的问题，style-loader不局限 vue 项目，功能更多一点。
resolve.alias 定义路径别名
配置 rspack.config.js,extensions配置解析的模块。
{resolve: {alias: {"@": path.resolve(__dirname, "./src"),},extensions: [".js", ".jsx", ".vue",".mjs"],},
}
升级到了rspack@0.5,需要单独安装@rspack/core
将之前配置的builtins.html ,调整为内置的插件进行配置
const rspack = require("@rspack/core");// ...
{// builtins: {// html: [{ template: path.resolve(__dirname, "public/index.html") }],// },plugins: [new VueLoaderPlugin(),new rspack.HtmlRspackPlugin({ template: "public/index.html" }),],
}
最近已经发布了
rspack@0.6，更新速度还是可以的。对于 webpack 生态的兼容，很适合旧项目的迁移升级。😀
rsbuild 基于 rspack 的构建工具
官方推荐的基于 rspack 的 web 构建工具。是 webpack 迁移到 rspack 的最佳方案。
- 易于配置，提供开箱即用的构建能力。
- 集成了 Rspack，SWC 和 Lightning CSS 等高性能工具。
- 内置插件系统，可以使用现有大多数的 webpack 插件和所有的 rspack 插件
npm create rsbuild@latest 按照提示
选择了vue3\typescript,暂时没有其他的选项
安装好依赖npm i,启动：
安装@rsbuild/plugin-babel @rsbuild/plugin-vue-jsx 支持 vue jsx/tsx 语法
新增配置rsbuild.config.ts
import { defineConfig } from "@rsbuild/core";
import { pluginVue } from "@rsbuild/plugin-vue";
import { pluginBabel } from "@rsbuild/plugin-babel";
import { pluginVueJsx } from "@rsbuild/plugin-vue-jsx";export default defineConfig({plugins: [pluginBabel({include: /\.(?:jsx|tsx)$/,exclude: /[\\/]node_modules[\\/]/,}),pluginVueJsx(),pluginVue(),],
});
安装vue配套设施vuex\vue-router\axios等。完善整个脚手架。详情查看仓库https://gitee.com/ngd_b/rspack-vue3/tree/rsbuild-vue3/
npx rsbuild inspect 查看默认的配置
包含两个文件rsbuild.config.mjs\rspack.config.web，可以通过项目下的rsbuild.config.ts文件进行修改。
可通过--env production 选项来输出生成环境下的配置。
- 增加路径别名，引文是 ts 项目，所以优先在
tsconfig.json中配置，也可以在rsbuild.config.ts
{"compilerOptions": {"paths": {"@/*": ["./src/*"]}}
}
- 内置了
less\sass预处理器。 - 重新配置了 html 模板，新建
pulbic目录，创建index.html文件，修改配置
{html:{template:"./public/index.html"},
}
rsdoctor 构建分析工具
可以将编译行为及耗时可视化展示。只支持构建过程分析；自定义构建扫描规则。
安装:
$> npm add @rsdoctor/rspack-plugin -D
增加配置rsbuild.config.ts
import { RsdoctorRspackPlugin } from '@rsdoctor/rspack-plugin';{tools:{rspack(config, { appendPlugins }) {// 仅在 RSDOCTOR 为 true 时注册插件，因为插件会增加构建耗时if (process.env.RSDOCTOR) {appendPlugins(new RsdoctorRspackPlugin({// 插件选项}),);}},}
}
RSDOCTOR在执行构建时，增加变量开启构建分析。RSDOCTOR=true npm run build
最近在升级旧项目，会写一篇记录文章，编译打包速度至少提升了 60% 👍 ，还在调整中。
