前端工程化 / 系统课时

理解依赖优化流程

理解依赖优化流程

Vite 的依赖优化只发生在开发阶段。本课把首次启动、依赖扫描、预构建、文件缓存和浏览器缓存串成一条完整链路,帮助你解释冷启动为何较慢、后续启动为何更快,以及新增依赖后为什么可能出现一次重新加载。

学习目标

  • 说明依赖预构建解决的兼容性与请求数量问题
  • 描述从依赖发现到浏览器缓存命中的完整流程
  • 判断哪些变化会触发重新优化,并能主动清理缓存验证

依赖优化解决什么问题

Vite 开发服务器以原生 ESM 方式向浏览器提供模块,但项目依赖不一定都是浏览器可直接消费的 ESM。依赖优化会处理 CommonJS、UMD 等格式的兼容问题,使命名导入等写法在开发环境中正常工作。

另一个目标是减少浏览器请求。某些 ESM 包内部拆成数百个文件,直接加载会产生大量并发请求。预构建会把这类依赖整理成更少的模块,降低浏览器侧的请求与解析开销。该过程不等同于生产构建,只服务于开发服务器。

从启动到缓存命中

没有可用缓存时,Vite 会扫描源码中的裸模块导入,例如 import debounce from 'lodash-es/debounce',把发现的依赖作为预构建入口。当前开发流程使用 Rolldown 完成依赖预构建,并把结果写入 node_modules/.vite。

Vite 依赖优化从冷启动到缓存命中的流程

浏览器请求优化后的依赖时,响应会使用长期强缓存。依赖版本或优化结果变化后,请求中的版本标识随之变化,浏览器会把它视为新资源。因此,文件系统缓存负责减少重复预构建,浏览器缓存负责减少重复下载,两者不是同一层缓存。

解释三种启动表现

场景 Vite 的主要动作 常见表现
首次启动或缓存失效 扫描依赖并执行预构建 启动时间略长,首次页面加载后趋于稳定
缓存有效的再次启动 复用 node_modules/.vite 启动更快,依赖请求直接命中浏览器缓存
运行中发现新依赖 补充预构建并按需刷新页面 页面可能出现一次额外重载,之后恢复稳定

如果项目首次启动很快,但打开某个懒加载页面时突然重新优化,通常不是 HMR 失效,而是该页面引入的依赖没有在初始扫描阶段被发现。此时应先确认导入是否由动态路径或插件转换生成,再决定是否配置 optimizeDeps.include。

强制重新优化并验证

当你修改了链接依赖、怀疑缓存陈旧,或需要复现冷启动行为时,可以忽略现有优化缓存重新启动开发服务器。

bash
npm run dev -- --force

预期输出如下,版本、耗时和端口会因环境不同而变化。

text
Forced re-optimization of dependencies

VITE v<VERSION>  ready in <TIME> ms

Local: http://localhost:<PORT>/

执行后打开页面并观察两点:终端不应持续重复出现依赖重新优化;同一路由第二次加载时,依赖请求数量与加载时间应保持稳定。若浏览器仍使用旧结果,可在开发者工具的 Network 面板临时禁用缓存,然后再次执行 --force 并刷新页面。

哪些变化会触发重新优化

Vite 会根据包管理器锁文件内容、补丁目录修改时间、影响依赖优化的 Vite 配置以及 NODE_ENV 判断文件缓存是否仍然有效。依赖安装或锁文件变化通常会在下次启动时自动触发重新优化。

npm link、pnpm link 一类链接关系变化不一定体现在锁文件中,因此可能无法自动使缓存失效。链接或取消链接本地包后,应优先使用 --force,而不是先修改业务代码或关闭 HMR。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解依赖优化流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通