vite依赖预构建(源码分析)

vite主张的是no bundle, 但是在开发环境,对于第三方依赖会基于esbuild进行依赖预构建,为什么选择esbuild,根据测试,发现esbuild构建速度对比rollup webpack非常快,开发环境注重效率。

依赖为什么需要预构建

性能方面考虑

  1. 如果依赖不构建,那么加载依赖的时候,比如lodash,有数百个模块,加载多次,影响性能,所以将依赖构建后,统一一个出口透出。

统一成ES Module

  1. 有些第三方包对外透出的是CommonJS和UMD等格式,需要将其转换成ESM格式,然后才能在浏览器中正常加载

vite预构建产物

构建产物会缓存在node_modules/.vite目录下

依赖预构建源码流程解析

主流程如下,主要实现在createDepsOptimizer()中

第一步:缓存判断

  1. 主要根据metadata中的lock文件的hash值和lock文件的生成的hash比对是否一致, metadata中的configHash值和config内容生成的hash比对是否一致;主要判断optimizeDeps上的配置,是否有变更;
js 复制代码
const lockfileFormats = [
  { name: "package-lock.json", checkPatches: true, manager: "npm" },
  { name: "yarn.lock", checkPatches: true, manager: "yarn" },
  // Included in lockfile for v2+
  { name: "pnpm-lock.yaml", checkPatches: false, manager: "pnpm" },
  // Included in lockfile
  { name: "bun.lockb", checkPatches: true, manager: "bun" }
].sort((_, { manager }) => {
  return process.env.npm_config_user_agent?.startsWith(manager) ? 1 : -1;
});
js 复制代码
      optimizeDeps: {
        include: optimizeDeps2?.include ? unique(optimizeDeps2.include).sort() : void 0,
        exclude: optimizeDeps2?.exclude ? unique(optimizeDeps2.exclude).sort() : void 0,
        esbuildOptions: {
          ...optimizeDeps2?.esbuildOptions,
          plugins: optimizeDeps2?.esbuildOptions?.plugins?.map((p) => p.name)
        }
      }
lua 复制代码
    if (cachedMetadata) {
      if (cachedMetadata.lockfileHash !== getLockfileHash(config)) {
        config.logger.info(
          "Re-optimizing dependencies because lockfile has changed"
        );
      } else if (cachedMetadata.configHash !== getConfigHash(config, ssr)) {
        config.logger.info(
          "Re-optimizing dependencies because vite config has changed"
        );
      } else {
        log?.("Hash is consistent. Skipping. Use --force to override.");
        return cachedMetadata;
      }
    }

第二步:发现依赖&依赖收集

扫描入口判断

判断是否有指定的optimizeDeps的entries和input等配置,找到依赖扫描的入口,如果没有入口就指定根路径的html文件为入口;

js 复制代码
async function computeEntries(config) {
  let entries = [];
  const explicitEntryPatterns = config.optimizeDeps.entries;
  const buildInput = config.build.rollupOptions?.input;
  if (explicitEntryPatterns) {
    entries = await globEntries(explicitEntryPatterns, config);
  } else if (buildInput) {
    const resolvePath = (p) => path$n.resolve(config.root, p);
    if (typeof buildInput === "string") {
      entries = [resolvePath(buildInput)];
    } else if (Array.isArray(buildInput)) {
      entries = buildInput.map(resolvePath);
    } else if (isObject$1(buildInput)) {
      entries = Object.values(buildInput).map(resolvePath);
    } else {
      throw new Error("invalid rollupOptions.input value.");
    }
  } else {
    entries = await globEntries("**/*.html", config);
  }
  entries = entries.filter(
    (entry) => isScannable(entry, config.optimizeDeps.extensions) && fs__default.existsSync(entry)
  );
  return entries;
}

准备扫描器

主要基于esbuild.context(), 生成依赖扫描器,并把自定义的插件esbuildScanPlugin传递进去;

生成依赖, 存储在deps

js 复制代码
return context.rebuild().then(() => {
  return {
    // Ensure a fixed order so hashes are stable and improve logs
    deps: orderedDependencies(deps),
    missing
  };

第三步:打包依赖

将上一步收集到的depsInfo依赖列表,传递给esbuild.context()来进行分析,然后调用rebuild()这一步依赖就生成了。

依赖路径重写

我们在源码中的写的Import, 最后被重写成esbuild预构建后的路径

实现原理

在createServer阶段,就注册了多个中间件,当浏览器请求main.ts时,会触发transformMiddleware

主要流程

vite:import-analysis插件

  1. 通过es-module-lexer提取出所有的import数据;
  2. 通过上面依赖预构建生成的dep,可以获取到esbuild生成的路径,interopNamedImports()中替换源码中的路径生成新的code;
相关推荐
Mh6 分钟前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳1 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔1 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart2 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
ShineWinsu3 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
Flynt3 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
nice_lcj5204 小时前
MySQL 主从复制与读写分离:从库怎么跟着主库走
数据库·mysql·面试·binlog·读写分离·主从复制
程序员韩星4 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson4 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器