Vite 源码解析之构建与预览

一、vite build 构建生产版本

Vite 将配置转化为 rollup 配置,然后利用 rollup 打包。注意,Vite 只完成配置转换,打包工作由 rollup 完成,配置内容 👉 构建选项

1.1 解析 vite 配置

在该步骤中会读取 Vite 配置文件(如 vite.config.ts)并结合命令行选项经过解析合成得到最终的配置项,推荐阅读"五千字剖析 vite 是如何对配置文件进行解析的"

1.2 合成 rollup input 配置

代码 示例

input 包含了三种模式 ssr、库模式、普通应用模式,我们项目中一般不需要关注,默认是 index.html;

plugin 加入了非常多 vite 内置的插件,例如alias、css、esbuild、asset、terser等等;

1.3 合成 rollup output 配置

主要定义了产物的名称、输出目录、格式、js 版本等等。

代码 示例

1.4 调用 rollup 打包并产出

代码 示例

rollup 输出的两种模式:

  • write:将 bundle 直接写入磁盘
  • generate:在内存中生成输出的代码,这常用于 编程式地调用 build() 在写入磁盘之前,需要对构建后的文件进行进一步处理。

1.5 监听构建时文件变动

如果设置了 watch 属性,则提供构建时的监听属性支持。利用 rollup.watch 函数(基于 chokidar),当 vite.config.js 以及任何要打包的文件改动都将触发重新构建。

二、vite preview 本地预览构建产物

配置内容 👉 预览选项

前置知识:整个 http 服务基于connect 库来实现

tsx 复制代码
/*
 * connect 基础用法
 */
// 1. Create an app
var app = connect();
// 2. Use middleware
app.use(function middleware1(req, res, next) { next() });
app.use(function middleware2(req, res, next) { next() });
// 2. Create a server from the app
var server = http.createServer(app).listen(port);

2.1 解析 vite 配置

2.2 判断构建产物是否存在

如果产物不存在就会直接报错了:

2.3 创建 http 服务

创建 http 服务基于connect 库来实现:

其中 resolveHttpServer 中根据不同的配置使用 hhtp/https/http2 服务:

  1. 如果未配置 https 属性则使用 http(默认情况下);
  2. 如果配置 https 属性,同时又设置了 proxy 属性,则会降级为 TLS;
  3. 如果配置 https 属性且未设置了 proxy 属性,则启用启用 TLS + HTTP/2;

2.4 执行插件中配置预览服务器的钩子

分为中间件之前和中间件之后执行,详见 configurePreviewServer

tsx 复制代码
const myPlugin = () => ({
  name: 'configure-preview-server',
  configurePreviewServer(server) {
    // ...其他中间件安装之前后调用
    
    // 返回一个钩子,会在其他中间件安装完成后调用
    return () => {
      server.middlewares.use((req, res, next) => {
        // 自定义处理请求 ...
      })
    }
  },
});
之前 之后

2.5 使用中间件

connect 库的核心就是中间件

2.6 启动 http 服务

主函数

httpServerStart

注意,如果端口号被占用,则会在错误回调函数中进行处理,如果 strictPort 设置为true,则直接退出不会再进行后续端口尝试,否则端口号会自动++尝试。

2.7 打开浏览器

内部主要基于 open 库实现。

三、总结

构建和预览主要基于 RollupConnect 两个库来实现其相应的功能。

vite build 构建

vite preview 预览

参考资料

One More Thing:如何调试 Vite 源码?

第一种:在 vite 源码中使用 playground 示例进行调试

# 步骤 示例
1 在 Vite 源码目录 packages/vite 中构建 Vite:pnpm run dev
2 在源码文件中找到期望调试的地方并打上断点
3 在 VSCode 中进入 debuger 模式
4 选择 playground 中的任意示例,执行相应命令就能跳转到对应断点位置

第二种:在自己项目中进行 vite 源码调试

# 步骤 示例
1 node_modules/vite/dist/node 中找到期望调试的地方并打上断点
2 在 VSCode 中进入 debuger 模式,执行相应命令就能跳转到对应断点位置

也可以用软链接的方式将 node_modules/vite 的内容更改为 vite 源码内容:

  • 在 vite 源码目录 packages/vite 中执行 pnpm link --global
  • 在项目目录下执行 pnpm link --global vite
  • 取消软链接 pnpm unlink
相关推荐
mldong5 小时前
你的 Vue3 项目也能有钉钉同款审批流设计器:npm 装包,10 分钟画出第一条审批流
前端·vue.js
2分钟速写快排5 小时前
什么是 RAG?如何用 RAG 实现一个用户记忆?
前端·后端·ai编程
passerby60616 小时前
如何自己造一个时间处理库
前端·javascript·github
走到天涯海角7 小时前
react里面的长列表渲染优化
前端·react.js·前端框架
小羊没烦恼!7 小时前
Hello Web API系列教程——Web API与国际化
java·服务器·前端·javascript·php
北岛贰7 小时前
迷茫焦虑期,我做了一个带支付带官网的 AI 聊天虚拟恋人 App
前端·人工智能·后端
mayaairi9 小时前
Vue2 组件通讯(三):全局事件总线、PubSub、插槽与组件实例属性
前端·javascript·vue.js
kyriewen9 小时前
面试官问我:AI 都能写代码了,前端凭什么还值 25K
前端·javascript·人工智能
风骏时光牛马10 小时前
AI源码分析:拆解模型底层实现逻辑
前端
IT_陈寒10 小时前
React子组件莫名其妙重渲染?你可能漏了这个Hook
前端·人工智能·后端