将 React 应用迁移至 Vite

300次阅读  |  发布于1年以前

前言

当下，在项目开发的过程中，对于大多数人来说，会使用 create react app 来创建 react 应用，它开箱即用，零配置，但随着项目中代码量的增加，你的项目构建时间也会随之增加，开发服务启动时间变得缓慢，代码更改后热更新也会变慢，可能会需要 2-5s 才会在页面上体现，那么能否提高构建速度，减少开发者等待的时间呢？

如何提升构建速度？

我们可以将构建工具迁移到 Vite[1]。

Vite 是下一代前端构建工具，可以更快地构建应用程序。

Vite 的亮点

创建 vite 新项目

使用以下命令创建全新的 react 应用程序。

yarn create vite my-react-app --template react

CRA 为什么慢？

Create react app 使用 wabpack 来打包。

webpack 打包图

如上图所示，它将整个项目的代码打包在一起，然后才能启动服务。

Vite 为什么快？

Vite 将会使用 esbuild[2] 预构建依赖[3]。esbuild 使用 Go 编写，并且相比 JavaScript 编写的 babel 打包器预构建依赖快 10-100 倍。

依赖预构建

当你首次启动 vite 时，你可能会注意到打印出了以下信息：


Pre-bundling dependencies: （正在预构建依赖：）
  react,
  react-dom
(this will be run only when your dependencies or config have changed)（这将只会在你的依赖或配置发生变化时执行）

依赖预构建的目的:

  1. Vite 必须先将作为 CommonJS 或 UMD 发布的依赖项转换为 ESM。
  2. 性能： Vite 将有许多内部模块的 ESM 依赖关系转换为单个模块，例如，lodash-es 有超过 600 个内置模块！通过预构建 lodash-es 成为一个模块，我们就只需要一个 HTTP 请求了！

按需加载

Vite 通过在一开始将应用中代码区分为 依赖 和 源码 两类，改进了开发服务器启动时间。

如上图所示，当浏览器请求时，Vite 只需要按需编译当前屏幕使用的代码。

缓存优化

Vite 是直接把转换后的 ES module 的 JavaScript 代码，给支持 ES module 的浏览器，让浏览器自己去加载依赖，也就是把压力丢给了浏览器，从而达到了项目启动速度快的效果。在我们修改其中一个代码模块的时候，Vite 热更新非常快，源码中模块的请求会根据 304 Not Modified 进行协商缓存，而依赖模块请求则会通过 Cache-Control: max-age=31536000,immutable 进行强缓存，因此一旦被缓存它们将不需要再次请求。

时间对比

我拿一个 create react app 项目， 该项目包含 3 个路由页面，14 个组件，迁移到 vite，也就是大家常说的 cra 来测试过，我们一起来对比下时间:

开发模式

CRA 12 s，vite 298 ms。Vite 开发环境是懒编译模式， 298ms 只是启动 devServer 的时间，不包含资源编译，只有你用浏览器去请求页面了，它才会进行编译，但是 CRA 是一次性把所有资源都编译、打包了。 打包模式

CRA 15.66 s，vite 9.11 s

从 CRA 迁移到 Vite

那么我是如何从老项目迁移到 vite 的呢？

"devDependencies": {
  "@vitejs/plugin-react": "1.1.1",
  "vite": "2.7.0"
},

"scripts": {
  // 开发阶段启动 Vite Dev Server
  "dev": "vite",
  // 生产环境打包
  "build": "tsc && vite build",
  // 生产环境打包完预览产物
  "preview": "vite preview"
},

"scripts": {
  // 开发阶段启动 Vite Dev Server
  "dev": "vite",
  // 生产环境打包
  "build": "tsc && vite build",
  // 生产环境打包完预览产物
  "preview": "vite preview"
},

可以看到配置文件中默认在 plugins 数组中配置了官方的 react 插件，来提供 React 项目编译和热更新的功能。

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
const { resolve } = require('path')

// https://vitejs.dev/config/
export default defineConfig({
  base: './',
  resolve: {
    alias: {
      '@components': resolve(__dirname, 'src', 'components'),
      '@utils': resolve(__dirname, 'src', 'utils'),
      '@config': resolve(__dirname, 'src', 'config'),
    },
  },
  plugins: [react()]
})

//修改前
<link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
//修改后
<link rel="icon" href="/favicon.ico" />

<div id="root"></div>
<script type="module" src="/src/index.jsx"></script>

REACT_APP_XXX 的环境变量，则切换为 VITE_XXX，假如有一个 .env 文件：

// 修改前
REACT_APP_ENV = local
// 修改后
VITE_ENV = local

如果项目使用了 sass，则需要执行命令进行安装：

$ yarn add -D sass

如果 scss 文件里面引入了一些 node_modules 的 css 是使用 ~ 符号的，可以做出调整：

@import '~antd/dist/antd.css';

调整为

@import 'antd/dist/antd.css';

可以参考 issue - Cannot import CSS from node_modules using "~" pattern[4]

若能够成功启动，那么恭喜你，项目迁移成功了，若不能启动，我们可以根据命令行中的提示，参照Vite 文档修改。

遇到问题

decorators not support

项目代码中如果使用了装饰器，比如 redux 提供的 connect 来绑定状态，形如：

@connect(state =&gt; state.foo)
class Foo extends React.PureComponent {
    ....
}

但是 decorators 语法居然不被 vite 支持，关于这个问题，也有一个issus，目前没有一个好的解决办法，只好去掉 decorators，改用常规的函数绑定了。

无法按需加载样式文件

如果项目组使用了 antd 组件库，本来会使用 babel-plugin-import 来自动导入组件和样式， vite 对 babel-plugin-import 支持不那么好，那么就要手动修改代码。

// 修改前
import { Button } from 'antd';

// 修改后
import Button from 'antd/lib/button';
import 'antd/lib/button/style/index.css';

也可以使用 vite-plugin-imp

'default' is not exported

有时候三方依赖项加载会出错，例如'default' is not exported 等，这里可以参考 issues

在实际迁移过程中，还是难免遇到一些奇怪的问题，这都是尝鲜的代价。

小结

Vite 充分利用了浏览器的加载机制和缓存机制等，大大提示了研发效率，vite 虽然快，但不是所有的项目 react 项目都可以迁移成功，若有些项目的中的 npm 包并不遵循 CommonJS 的规范，那就可能迁移失败，或者需要写一些自定义插件来适配，所以笔者认为不要激进地直接重构一些已有的大型项目，打包不是目的，运行才是，若有些项目 webpack 配置特别复杂，那么我们可以升级到 webpack5，或者开启 webpack5 懒编译模式[5]等， 这样既能提升部分构建效率，也可以保证项目能够稳定运行。

以上就是本文全部内容，希望这篇文章对大家有所帮助，也可以参考我往期的文章或者在评论区交流你的想法和心得，欢迎一起探索前端。

Copyright© 2013-2020

All Rights Reserved 京ICP备2023019179号-8