原文地址

背景

这里的背景介绍会从与Vite紧密相关的两个概念的发展史说起,一个是JavaScript的模块化标准,另一个是前端构建工具。

共存的模块化标准

为什么JavaScript会有多种共存的模块化标准?因为js在设计之初并没有模块化的概念,随着前端业务复杂度不断提高,模块化越来越受到开发者的重视,社区开始涌现多种模块化解决方案,它们相互借鉴,也争议不断,形成多个派系,从CommonJS开始,到ES6正式推出ES Modules规范结束,所有争论,终成历史,ES Modules也成为前端重要的基础设施。

  • CommonJS:现主要用于Node.js(Node@13.2.0开始支持直接使用ES Module)
  • AMD:require.js 依赖前置,市场存量不建议使用
  • CMD:sea.js 就近执行,市场存量不建议使用
  • ES Module:ES语言规范,标准,趋势,未来

对模块化发展史感兴趣的可以看下《前端模块化开发那点历史》@玉伯[2],而Vite的核心正是依靠浏览器对ES Module规范的实现。

发展中的构建工具

近些年前端工程化发展迅速,各种构建工具层出不穷,目前Webpack仍然占据统治地位,npm 每周下载量达到两千多万次。下面是我按 npm 发版时间线列出的开发者比较熟知的一些构建工具。
2022/03/09 【下一代前端开发利器——Vite(原理源码解析)】 - 图1

当前工程化痛点

现在常用的构建工具如Webpack,主要是通过抓取-编译-构建整个应用的代码(也就是常说的打包过程),生成一份编译、优化后能良好兼容各个浏览器的的生产环境代码。在开发环境流程也基本相同,需要先将整个应用构建打包后,再把打包后的代码交给dev server(开发服务器)。
Webpack等构建工具的诞生给前端开发带来了极大的便利,但随着前端业务的复杂化,js代码量呈指数增长,打包构建时间越来越久,dev server(开发服务器)性能遇到瓶颈:

  • 缓慢的服务启动: 大型项目中dev server启动时间达到几十秒甚至几分钟。
  • 缓慢的HMR热更新: 即使采用了 HMR 模式,其热更新速度也会随着应用规模的增长而显著下降,已达到性能瓶颈,无多少优化空间

缓慢的开发环境,大大降低了开发者的幸福感,在以上背景下Vite应运而生。


什么是Vite?

基于esbuild与Rollup依靠浏览器自身ESM编译功能, 实现极致开发体验的新一代构建工具!

概念

先介绍以下文中会经常提到的一些基础概念:

  • 依赖: 指开发不会变动的部分(npm包、UI组件库),esbuild进行预构建。
  • 源码: 浏览器不能直接执行的非js代码(.jsx、.css、.vue等),vite只在浏览器请求相关源码的时候进行转换,以提供ESM源码。

    开发环境

  • 利用浏览器原生的ES Module编译能力,省略费时的编译环节,直给浏览器开发环境源码,dev server只提供轻量服务。

  • 浏览器执行ESM的import时,会向dev server发起该模块的ajax请求,服务器对源码做简单处理后返回给浏览器。
  • Vite中HMR是在原生 ESM 上执行的。当编辑一个文件时,Vite 只需要精确地使已编辑的模块失活,使得无论应用大小如何,HMR 始终能保持快速更新。
  • 使用esbuild处理项目依赖,esbuild使用go编写,比一般node.js编写的编译器快几个数量级。

    生产环境

  • 集成Rollup打包生产环境代码,依赖其成熟稳定的生态与更简洁的插件机制。

    处理流程对比

    Webpack通过先将整个应用打包,再将打包后代码提供给dev server,开发者才能开始开发。开发者才能开始开发。
    2022/03/09 【下一代前端开发利器——Vite(原理源码解析)】 - 图2
    Vite直接将源码交给浏览器,实现dev server秒开,浏览器显示页面需要相关模块时,再向dev server发起请求,服务器简单处理后,将该模块返回给浏览器,实现真正意义的按需加载。2022/03/09 【下一代前端开发利器——Vite(原理源码解析)】 - 图3


基本用法

创建vite项目

  1. npm create vite@latest

选取模板

Vite 内置6种常用模板与对应的TS版本,可满足前端大部分开发场景,可以点击下列表格中模板直接在 StackBlitz[3] 中在线试用,还有其他更多的 社区维护模板[4]可以使用。

JavaScript TypeScript
vanilla vanilla-ts
vue vue-ts
react react-ts
preact preact-ts
lit lit-ts
svelte svelte-ts

启动

  1. {
  2. "scripts": {
  3. "dev": "vite", // 启动开发服务器,别名:`vite dev`,`vite serve`
  4. "build": "vite build", // 为生产环境构建产物
  5. "preview": "vite preview" // 本地预览生产构建产物
  6. }
  7. }

实现原理

ESbuild 编译

esbuild 使用go编写,cpu密集下更具性能优势,编译速度更快,以下摘自官网的构建速度对比:
浏览器:“开始了吗?”
服务器:“已经结束了。”
开发者:“好快,好喜欢!!”
2022/03/09 【下一代前端开发利器——Vite(原理源码解析)】 - 图4
image.png

依赖预构建

  • 模块化兼容: 如开头背景所写,现仍共存多种模块化标准代码,Vite在预构建阶段将依赖中各种其他模块化规范(CommonJS、UMD)转换 成ESM,以提供给浏览器。
  • 性能优化: npm包中大量的ESM代码,大量的import请求,会造成网络拥塞。Vite使用esbuild,将有大量内部模块的ESM关系转换成单个模块,以减少 import模块请求次数。

    重写模块路径

    浏览器import只能引入相对/绝对路径,而开发代码经常使用npm包名直接引入node_module中的模块,需要做路径转换后交给浏览器。

  • es-module-lexer 扫描 import 语法

  • magic-string 重写模块的引入路径 ```javascript // 开发代码 import { createApp } from ‘vue’

// 转换后 import { createApp } from ‘/node_modules/vue/dist/vue.js’

  1. <a name="lsjOe"></a>
  2. # 源码分析
  3. 与Webpack-dev-server类似Vite同样使用WebSocket与客户端建立连接,实现热更新,源码实现基本可分为两部分,源码位置在:
  4. - vite/packages/vite/src/client client(用于客户端)
  5. - vite/packages/vite/src/node server(用于开发服务器)
  6. client 代码会在启动服务时注入到客户端,用于客户端对于WebSocket消息的处理(如更新页面某个模块、刷新页面);server 代码是服务端逻辑,用于处理代码的构建与页面模块的请求。<br />简单看了下源码(vite@2.7.2),核心功能主要是以下几个方法(以下为源码截取,部分逻辑做了删减):
  7. 1. 命令行启动服务npm run dev后,源码执行cli.ts,调用createServer方法,创建http服务,监听开发服务器端口。
  8. ```javascript
  9. // 源码位置 vite/packages/vite/src/node/cli.ts
  10. const { createServer } = await import('./server')
  11. try {
  12. const server = await createServer({
  13. root,
  14. base: options.base,
  15. ...
  16. })
  17. if (!server.httpServer) {
  18. throw new Error('HTTP server not available')
  19. }
  20. await server.listen()
  21. }
  1. createServer方法的执行做了很多工作,如整合配置项、创建http服务(早期通过koa创建)、创建WebSocket服务、创建源码的文件监听、插件执行、optimize优化等。下面注释中标出。


  1. // 源码位置 vite/packages/vite/src/node/server/index.ts
  2. export async function createServer(
  3. inlineConfig: InlineConfig = {}
  4. ): Promise<ViteDevServer> {
  5. // Vite 配置整合
  6. const config = await resolveConfig(inlineConfig, 'serve', 'development')
  7. const root = config.root
  8. const serverConfig = config.server
  9. // 创建http服务
  10. const httpServer = await resolveHttpServer(serverConfig, middlewares, httpsOptions)
  11. // 创建ws服务
  12. const ws = createWebSocketServer(httpServer, config, httpsOptions)
  13. // 创建watcher,设置代码文件监听
  14. const watcher = chokidar.watch(path.resolve(root), {
  15. ignored: [
  16. '**/node_modules/**',
  17. '**/.git/**',
  18. ...(Array.isArray(ignored) ? ignored : [ignored])
  19. ],
  20. ...watchOptions
  21. }) as FSWatcher
  22. // 创建server对象
  23. const server: ViteDevServer = {
  24. config,
  25. middlewares,
  26. httpServer,
  27. watcher,
  28. ws,
  29. moduleGraph,
  30. listen,
  31. ...
  32. }
  33. // 文件监听变动,websocket向前端通信
  34. watcher.on('change', async (file) => {
  35. ...
  36. handleHMRUpdate()
  37. })
  38. // 非常多的 middleware
  39. middlewares.use(...)
  40. // optimize
  41. const runOptimize = async () => {...}
  42. return server
  43. }

使用chokidar[5]监听文件变化,绑定监听事件。

  1. // 源码位置 vite/packages/vite/src/node/server/index.ts
  2. const watcher = chokidar.watch(path.resolve(root), {
  3. ignored: [
  4. '**/node_modules/**',
  5. '**/.git/**',
  6. ...(Array.isArray(ignored) ? ignored : [ignored])
  7. ],
  8. ignoreInitial: true,
  9. ignorePermissionErrors: true,
  10. disableGlobbing: true,
  11. ...watchOptions
  12. }) as FSWatcher

通过 ws[6] 来创建WebSocket服务,用于监听到文件变化时触发热更新,向客户端发送消息。

  1. // 源码位置 vite/packages/vite/src/node/server/ws.ts
  2. export function createWebSocketServer(...){
  3. let wss: WebSocket
  4. const hmr = isObject(config.server.hmr) && config.server.hmr
  5. const wsServer = (hmr && hmr.server) || server
  6. if (wsServer) {
  7. wss = new WebSocket({ noServer: true })
  8. wsServer.on('upgrade', (req, socket, head) => {
  9. // 服务就绪
  10. if (req.headers['sec-websocket-protocol'] === HMR_HEADER) {
  11. wss.handleUpgrade(req, socket as Socket, head, (ws) => {
  12. wss.emit('connection', ws, req)
  13. })
  14. }
  15. })
  16. } else {
  17. ...
  18. }
  19. // 服务准备就绪,就能在浏览器控制台看到熟悉的打印 [vite] connected.
  20. wss.on('connection', (socket) => {
  21. socket.send(JSON.stringify({ type: 'connected' }))
  22. ...
  23. })
  24. // 失败
  25. wss.on('error', (e: Error & { code: string }) => {
  26. ...
  27. })
  28. // 返回ws对象
  29. return {
  30. on: wss.on.bind(wss),
  31. off: wss.off.bind(wss),
  32. // 向客户端发送信息
  33. // 多个客户端同时触发
  34. send(payload: HMRPayload) {
  35. const stringified = JSON.stringify(payload)
  36. wss.clients.forEach((client) => {
  37. // readyState 1 means the connection is open
  38. client.send(stringified)
  39. })
  40. }
  41. }
  42. }

在服务启动时会向浏览器注入代码,用于处理客户端接收到的WebSocket消息,如重新发起模块请求、刷新页面。

  1. //源码位置 vite/packages/vite/src/client/client.ts
  2. async function handleMessage(payload: HMRPayload) {
  3. switch (payload.type) {
  4. case 'connected':
  5. console.log(`[vite] connected.`)
  6. break
  7. case 'update':
  8. notifyListeners('vite:beforeUpdate', payload)
  9. ...
  10. break
  11. case 'custom': {
  12. notifyListeners(payload.event as CustomEventName<any>, payload.data)
  13. ...
  14. break
  15. }
  16. case 'full-reload':
  17. notifyListeners('vite:beforeFullReload', payload)
  18. ...
  19. break
  20. case 'prune':
  21. notifyListeners('vite:beforePrune', payload)
  22. ...
  23. break
  24. case 'error': {
  25. notifyListeners('vite:error', payload)
  26. ...
  27. break
  28. }
  29. default: {
  30. const check: never = payload
  31. return check
  32. }
  33. }
  34. }

优势

  • 快!快!非常快!!
  • 高度集成,开箱即用。
  • 基于ESM急速热更新,无需打包编译。
  • 基于esbuild的依赖预处理,比Webpack等node编写的编译器快几个数量级。
  • 兼容Rollup庞大的插件机制,插件开发更简洁。
  • 不与Vue绑定,支持React等其他框架,独立的构建工具。
  • 内置SSR支持。
  • 天然支持TS。

    不足

  • Vue仍为第一优先支持,量身定做的编译插件,对React的支持不如Vue强大。

  • 虽然已经推出2.0正式版,已经可以用于正式线上生产,但目前市场上实践少。
  • 生产环境集成Rollup打包,与开发环境最终执行的代码不一致。

与 webpack 对比

由于Vite主打的是开发环境的极致体验,生产环境集成Rollup,这里的对比主要是Webpack-dev-server与Vite-dev-server的对比:

  • 到目前很长时间以来Webpack在前端工程领域占统治地位,Vite推出以来备受关注,社区活跃,GitHub star 数量激增,目前达到37.4K2022/03/09 【下一代前端开发利器——Vite(原理源码解析)】 - 图5
  • Webpack配置丰富使用极为灵活但上手成本高,Vite开箱即用配置高度集成
  • Webpack启动服务需打包构建,速度慢,Vite免编译可秒开
  • Webpack热更新需打包构建,速度慢,Vite毫秒响应
  • Webpack成熟稳定、资源丰富、大量实践案例,Vite实践较少
  • Vite使用esbuild编译,构建速度比webpack快几个数量级

兼容性

  • 默认目标浏览器是在script标签上支持原生 ESM 和 原生 ESM 动态导入
  • 可使用官方插件 @vitejs/plugin-legacy,转义成传统版本和相对应的polyfill

未来探索

  • 传统构建工具性能已到瓶颈,主打开发体验的Vite,可能会受到欢迎。
  • 主流浏览器基本支持ESM,ESM将成为主流。
  • Vite在Vue3.0代替vue-cli,作为官方脚手架,会大大提高使用量。
  • Vite2.0推出后,已可以在实际项目中使用Vite。
  • 如果觉得直接使用Vite太冒险,又确实有dev server速度慢的问题需要解决,可以尝试用Vite单独搭建一套dev server

相关资源

官方插件

除了支持现有的Rollup插件系统外,官方提供了四个最关键的插件

  • @vitejs/plugin-vue 提供 Vue3 单文件组件支持
  • @vitejs/plugin-vue-jsx 提供 Vue3 JSX 支持(专用的 Babel 转换插件)
  • @vitejs/plugin-react 提供完整的 React 支持
  • @vitejs/plugin-legacy 为打包后的文件提供传统浏览器兼容性支持

    UI组件库

  • Element UI[7]:支持 vite 引入

    相关链接

  • Vite官网[8]

  • Vue3 生态进展和计划-尤雨溪[9]
  • Vite源码解析[10]
  • Develop with Vite | Vite快速入门 - Anthony Fu • Vue北京聚会 Day 13[11]

    参考资料

《Vue3 生态进展和计划》: https://www.yuque.com/vueconf/mkwv0c/xqyxix
《前端模块化开发那点历史》: https://github.com/seajs/seajs/issues/588
StackBlitz: https://vite.new/
社区维护模板: https://github.com/vitejs/awesome-vite#templates
chokidar: https://www.npmjs.com/package/chokidar
ws: https://www.npmjs.com/package/ws
Element UI: https://element-plus.gitee.io/zh-CN/guide/quickstart.html#%E6%8C%89%E9%9C%80%E5%AF%BC%E5%85%A5
Vite官网: https://cn.vitejs.dev/
Vue3 生态进展和计划-尤雨溪: https://www.yuque.com/vueconf/mkwv0c/xqyxix
Vite源码解析: http://vite.ssr-fc.com/
Develop with Vite | Vite快速入门 - Anthony Fu • Vue北京聚会 Day 13: https://www.youtube.com/watch?v=xx8gEHet6n8