我把大型团队项目从 vite 前端迁移到了 rsbuild，收益如何？

o翔哥o2024-10-15 20:26

背景

我们团队的项目一直是使用 vite 作为打包工具的，由于 vite 开发环境和生产环境的打包策略不同（开发环境按需打包，生产环境全量打包），所以存在开发环境和线上环境打包产物表现不一致的风险。其中 css 样式不一致的问题尤为容易发生，目前在需求开发过程中，已多次遇到本地开发环境 css 样式符合 UI 稿，发布到测试环境或者线上之后就出现了差异的场景。

基于上述背景，我们期望迁移至一款开发和生产环境打包产物一致的工具。

方案调研

除上述背景外，我们期望的打包工具还应该满足以下特性：

  • 开发和生产环境打包产物一致
  • 打包性能优异
  • 生态良好、项目足够稳定
  • 迁移成本较低

要满足打包性能优异的特性，除 vite 外，我们的打包工具范围最终锁定在由 rust 开发项目内：

Turbopack Farm Rsbuild（基于rspack）
产物一致性 ❌ 不一致 ✅ 一致 ✅ 一致
打包性能 ✅ 快 ✅ 快 ✅ 快
生态及稳定性 ❌ 全新生态，生态链较差 ✅ 兼容 vite 插件(先试验了下 farm，遇到的坑太多了且解决不了，根据 github 的用户数以及 npm 下载量，感觉目前尚未达到稳定可用状态) ✅ 兼容 webpack 插件且已有众多线上项目验证
迁移成本 ❌ 高(没有对应的插件) ❌ 高(踩坑太多且无解决思路，应该是farm本身的坑) ✅ 中

经过调研和实践，最终选定 rsbuild 作为最终的工具。

最终收益

  • 打包时长：300s 左右 > 60s 左右，性能提升大概 400% 左右

    • 迁移前 vite 打包时长：292s
    • 迁移后 webpack 打包时长：66s

  • 流水线构建时长：360s 左右 > 130s 左右，减少 150%（整条流水线上除了打包之外，还有拉代码仓库、代码质量检测、安装依赖、上传 CDN 等其他工作，而构建工具只是减少了打包这一阶段的工作时长，但打包依然是占最大头的，所以收益还是很明显）

  • 冷启动时长：

    • 首页面渲染：10s 左右 > 25s 左右（这里指的是从执行 npm run dev 到页面渲染出内容的时长）
    • 其他页面首次切换：5s 左右 > 1s 内（vite 由于资源是按需加载，在加载其他页面时需要对新页面资源进行 esbuild 构建，所以会慢）

    可以看到首屏冷启动时长性能有比较大的劣化，这是因为 vite 是根据页面按需资源打包，而 rsbuild 是全量打包。（但全量打包目前应该是解决开发和生产产物不一致的必要条件，为解决我们的背景问题必不可少）

    冷启动时长综合对比，如果在开发过程中切换页面比较多的话，最终的等待时长 rspack 会胜于 vite；如果只关注于一个页面的开发，vite 这方面占优

  • 热更新：0.5s 内 > 1.5s 内（都是很低的数值，体感没有差别）

  • 资源分包数：以我们项目的首屏为例，可以看到 rsbuild 的分包策略要由于 vite（打包总体积几乎无变化的情况下，分包数少了很多）：

    • css 文件数: 38项 > 9 项
    • js 文件数：81项 > 55 项

迁移过程及踩坑

安装相关依赖

安装 rsbuild 核心包：

sql 复制代码 
yarn add @rsbuild/core @rsbuild/plugin-babel @rsbuild/plugin-less @rsbuild/plugin-sass @rsbuild/plugin-vue @rsbuild/plugin-vue-jsx -D

其他插件根据自己项目的需要进行安装，可以在 rsbuild 官网找到。常用的有：

less 复制代码 
@rsbuild/plugin-babel
@rsbuild/plugin-less
@rsbuild/plugin-sass
@rsbuild/plugin-vue
@rsbuild/plugin-vue-jsx

更改打包配置文件

下面是以我们的项目为例（一些敏感代码没有在上面展示），将 vite.config.ts 迁移到 rsbuild.config.ts ，可以进行参考：

  • vite.config.ts：

    ts 复制代码 
    import { defineConfig, loadEnv, UserConfigExport } from 'vite';
import vue from '@vitejs/plugin-vue';
import vueJsx from '@vitejs/plugin-vue-jsx';
import Inspect from 'vite-plugin-inspect';
import AutoImport from 'unplugin-auto-import/vite';
import { codeInspectorPlugin } from 'code-inspector-plugin';
import path from 'path';

const isProduction = env => env === 'production';
const cdn = 'https://xxx.com/xyz/';

export default ({ mode }: { mode: string }): UserConfigExport =>
    defineConfig({
        base: isProduction(mode) ? cdn : '/',
        plugins: [
            vue(),
            vueJsx(),
            codeInspectorPlugin({
                bundler: 'vite',
            }), // 开发环境 Meta + shift 切换开启/关闭，点击 dom 跳转源代码
            AutoImport({
                imports: ['vue', 'vue-router'],
                dts: 'src/auto-import.d.ts',
            }),
        ],
        resolve: {
            alias: [
                {
                    find: '@',
                    replacement: path.resolve(__dirname, './src'),
                },
            ],
        },
        server: {
            host: '0.0.0.0',
            port: 4000,
            open: true,
            cors: true,
            proxy: {
                '/api/': {
                    target: loadEnv(mode, process.cwd()).VITE_APP_HOST, // 转发域名
                    changeOrigin: true,
                    headers: {
                        referer: loadEnv(mode, process.cwd()).VITE_APP_REFERER,
                        host: loadEnv(mode, process.cwd()).VITE_APP_HOST,
                        Cookie: loadEnv(mode, process.cwd()).VITE_APP_COOKIE, // 转发
                    },
                },
            },
        }
    });

  • rsbuild.config.ts：

    ts 复制代码 
    import { defineConfig } from '@rsbuild/core';
import { pluginVue } from '@rsbuild/plugin-vue';
import { pluginVueJsx } from '@rsbuild/plugin-vue-jsx';
import { pluginBabel } from '@rsbuild/plugin-babel';
import { pluginLess } from '@rsbuild/plugin-less';
import AutoImport from 'unplugin-auto-import/rspack';
import { codeInspectorPlugin } from 'code-inspector-plugin';
import path from 'path';


const isProduction = env => env === 'production';
const cdn = 'https://xxxx.com/xyz/';

const { VITE_APP_HOST, VITE_APP_COOKIE, VITE_APP_REFERER } = import.meta.env;

export default defineConfig(({ env }) => ({
    output: {
        assetPrefix: isProduction(env) ? cdn : '/',
        distPath: {
            root: 'dist',
            html: './',
            js: './',
            jsAsync: './',
            css: 'assets',
            cssAsync: 'assets',
            svg: 'assets',
            font: 'assets',
            image: 'assets',
            media: 'assets',
        },
        sourceMap: {
            js: isProduction(env) ? 'source-map' : 'cheap-module-source-map',
            css: true,
        },
    },
    plugins: [
        pluginLess({
            lessLoaderOptions: {
                lessOptions: {
                    javascriptEnabled: false,
                },
                implementation: require.resolve('less'),
            },
        }),
        pluginBabel({
            include: /.(?:jsx|tsx)$/,
        }),
        pluginVue(),
        pluginVueJsx(),
    ],
    tools: {
        htmlPlugin: {
            template: './index.html',
        },
        rspack: {
            plugins: [
                AutoImport({
                    imports: ['vue', 'vue-router'],
                    dts: 'src/auto-import.d.ts',
                }),
                codeInspectorPlugin({
                    bundler: 'rspack',
                }),
            ],
            module: {
                rules: [
                    {
                        resourceQuery: /raw/,
                        type: 'asset/source',
                    },
                ],
            },
        },
    },
    source: {
        alias: {
            '@': path.resolve(__dirname, './src'),
        },
        define: {
            'import.meta.env.VITE_APP_HOST': `'${VITE_APP_HOST}'`,
        },
    },
    server: {
        host: '0.0.0.0',
        port: 4000,
        open: true,
        cors: true,
        proxy: {
            '/api/': {
                target: loadEnv(mode, process.cwd()).VITE_APP_HOST, // 转发域名
                changeOrigin: true,
                headers: {
                    referer: loadEnv(mode, process.cwd()).VITE_APP_REFERER,
                    host: loadEnv(mode, process.cwd()).VITE_APP_HOST,
                    Cookie: loadEnv(mode, process.cwd()).VITE_APP_COOKIE, // 转发
                },
            },
        },
    },
}));

修改对应指令

json 复制代码 
// package.json
{
  "scripts": {
    "dev": "rsbuild dev",
    "build": "rsbuild build",
    "preview": "rsbuild preview",
    // others...
  },
  // ...others
}

修改 index.html

移除掉 index.html 之前的 <script src="main.ts"></script> 引入代码。

踩坑

import.meta 不兼容

import.meta 是浏览器 module 模块中独有的语法，rsbuild 在 rsbuild.config.js 中可以使用 import.meta，但是在项目源代码中并不支持，所以我们需要对原本代码中的 import.meta 进行适配。

以我们项目为例，大部分代码中的 import.meta.XXX 都是在本地的 .env.local 文件中定义的，我们可以借助 source.define 去进行全局的声明：

ts 复制代码 
import { defineConfig } from '@rsbuild/core';

const { VITE_APP_HOST } = import.meta.env;

export default defineConfig(({ env }) => ({
    source: {
        define: {
            'import.meta.env.VITE_APP_HOST': `'${VITE_APP_HOST}'`,
        },
    },
}));

另外我们项目还用到了 import.meta.url 去引入资源，这种需要改为 import 方式去引入：

javascript 复制代码 
// 改之前：
const href = new URL('../assets/icon.png', import.meta.url).href;

// 改之后：
import IconPNG from '../assets/icon.png';
const href = IconPNG;

:deep 和 & 兼容问题

目前已知 @rsbuild/plugin-less 插件对于在 :deep 内部使用 less 的 & 符号会有问题，例如：

  • case1: 生效
less 复制代码 
.container {
    .content {
        &_title {
            font-weight: bold;
        }
    }
}
  • case2: 生效
less 复制代码 
.container {
    :deep(.content) {
        .content_title {
            font-weight: bold;
        }
    }
}
  • case3: 不生效
less 复制代码 
.container {
    :deep(.content) {
        &_title {
            font-weight: bold;
        }
    }
}

后面会去 github 提个 issue，我们项目内部这种使用情况很少，所以暂时手动修改为不使用 &。

css 中使用 v-bind 不支持三元运算符

不支持在 css 中 v-bind 使用三元运算符，可以改成在 js 中使用三元运算符替代

less 复制代码 
// 改之前：
.container {
  height: v-bind(title ? '24px' : '48px');
}

// 改之后：
const containerHeight = title ? '24px' : '48px'; // js中写
.container {
  height: v-bind(containerHeight);
}

结论

我们的项目目前有 2500+ 文件、30w+ 行代码，算是一个很大的项目了。对于这样一个大型项目而言，从 vite 迁移 rsbuild 的过程中遇到的坑可以算很少了，而且迁移后的收益很明显，足以证明 rsbuild 及 rspack 是一个十分优秀的项目，且完全可以在生产环境中去应用了。

对于 webpack 构建的项目，我相信收益会更加明显，有折腾想法的朋友可以年底迁移一波作为 KPI 试试

最后的最后，快手基础平台团队招前端，欢迎在平台私信我投简历~

相关推荐
木子七17 分钟前
Js Dom
前端·javascript
谢小飞1 小时前
我做了三把椅子原来纹理这样加载切换
前端·three.js
圈圈的熊1 小时前
HTTP 和 HTTPS 的区别
前端·网络协议·http·https
GIS程序媛—椰子1 小时前
【Vue 全家桶】2、Vue 组件化编程
前端·javascript·vue.js
Beamon__1 小时前
element-plus按需引入报错IconsResolver is not a function
前端
努力奔波的程序猿1 小时前
HBuilderx修改主题色-改变编辑器背景颜色等
前端
正小安1 小时前
Vue 3 性能提升与 Vue 2 的比较 - 2024最新版前端秋招面试短期突击面试题【100道】
前端·vue.js·面试
yqcoder1 小时前
electron 中 ipcRenderer 的常用方法有哪些？
前端·javascript·electron
T0uken1 小时前
【Python】Bottle：轻量Web框架
开发语言·前端·python
热门推荐
01制冷毛细管的计算方法介绍02【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04AI 绘画Stable Diffusion 研究（十四）SD 图生图+剪映制作人物说话视频05(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明06【经验分享】Ubuntu22.04安装微信(linux官方版)07【Linux】UnixBench介绍、分数调优思路以及测试2D3D的方法08【Java】Ruoyi-Vue-Plus 整合 文件分片上传至 minio、阿里云、七牛云等OSS-【后端篇】09RAG 实践- Ollama+RagFlow 部署本地知识库10Docker 夺命连环 15 问