Vite实现秒级依赖预构建的核心是esbuild——用Go编写的高性能工具,将CommonJS/UMD依赖转为ESM、合并模块减少请求,并依托缓存机制与智能增量更新实现首次及后续快速启动。

Vite 在开发阶段实现秒级依赖预构建,核心靠的是 esbuild —— 一个用 Go 编写的超快 JavaScript 打包与转换工具。它不走 Node.js 的 JS 解析路径,而是直接编译执行,速度比 Webpack、Rollup 等传统工具快 10–100 倍。这种性能优势直接决定了 Vite 启动时依赖处理的“秒级”体验。
esbuild 负责把非 ESM 依赖转成浏览器能直接运行的格式
现代浏览器只认原生 ES 模块(ESM),但大量 npm 包仍发布 CommonJS(CJS)或 UMD 格式,比如 React、Lodash 等。Vite 无法让浏览器直接加载这些格式,必须提前转换。
- esbuild 会将 CJS/UMD 语法(如 require、module.exports)重写为标准 import/export
- 同时做静态分析,提取真正被用到的导出项(tree-shaking 初步效果),避免冗余代码
- 对像 lodash-es 这类本身是 ESM 但模块极碎的库,esbuild 把几百个文件合并成单个 deps/lodash-es.js,大幅减少 HTTP 请求
预构建只跑一次,且结果全程缓存复用
Vite 不会在每次启动都从头打包依赖,而是严格依赖缓存机制,极大压缩重复开销。
- 首次启动时,esbuild 扫描源码中所有 import 语句,识别来自 node_modules 的依赖,生成待构建列表
- 构建产物存入 node_modules/.vite/deps,并写入 _metadata.json 记录每个包的哈希、入口、输出路径
- 后续启动时,Vite 对比当前 package-lock.json、vite.config.js 中的 optimizeDeps 配置、以及依赖文件内容哈希 —— 只要没变,就跳过构建,直接复用缓存
自动扫描 + 智能增量更新,不卡启动流程
即使项目运行中动态引入新依赖(比如通过 import()),Vite 也能快速响应,不打断开发流。
- 开发服务器监听到未预构建的依赖请求时,会触发“按需预构建”,调用 esbuild 单独处理该依赖,完成后热更新页面
- esbuild 的并发编译能力让它能高效处理多个小依赖,而不会像 JS 工具那样因事件循环阻塞拖慢整体
- 构建过程由 Vite 内部的 esbuildScanPlugin 插件驱动,轻量、无副作用,不干扰源码编译逻辑
配置得当,能让预构建更稳更快
默认行为已经足够好,但在大型项目中,主动干预能进一步收束不确定性。
- include:显式列出高频、大体积或动态导入的依赖(如 dayjs、ahooks),防止漏扫导致运行时二次构建
- exclude:跳过已提供 ESM 且结构扁平的包(如某些 CDN 可直引的库),或体积过大、构建耗时长的包(如 jspdf),改用 script 标签引入
- 不手动清理缓存 —— Vite 自动判断变更;只有在怀疑缓存损坏时,才删掉 node_modules/.vite 目录强制重建


















