前端工程化 / 系统课时
理解依赖优化流程
理解依赖优化流程
Vite 的依赖优化只发生在开发阶段。本课把首次启动、依赖扫描、预构建、文件缓存和浏览器缓存串成一条完整链路,帮助你解释冷启动为何较慢、后续启动为何更快,以及新增依赖后为什么可能出现一次重新加载。
学习目标
- 说明依赖预构建解决的兼容性与请求数量问题
- 描述从依赖发现到浏览器缓存命中的完整流程
- 判断哪些变化会触发重新优化,并能主动清理缓存验证
依赖优化解决什么问题
Vite 开发服务器以原生 ESM 方式向浏览器提供模块,但项目依赖不一定都是浏览器可直接消费的 ESM。依赖优化会处理 CommonJS、UMD 等格式的兼容问题,使命名导入等写法在开发环境中正常工作。
另一个目标是减少浏览器请求。某些 ESM 包内部拆成数百个文件,直接加载会产生大量并发请求。预构建会把这类依赖整理成更少的模块,降低浏览器侧的请求与解析开销。该过程不等同于生产构建,只服务于开发服务器。
从启动到缓存命中
没有可用缓存时,Vite 会扫描源码中的裸模块导入,例如 import debounce from 'lodash-es/debounce',把发现的依赖作为预构建入口。当前开发流程使用 Rolldown 完成依赖预构建,并把结果写入 node_modules/.vite。

浏览器请求优化后的依赖时,响应会使用长期强缓存。依赖版本或优化结果变化后,请求中的版本标识随之变化,浏览器会把它视为新资源。因此,文件系统缓存负责减少重复预构建,浏览器缓存负责减少重复下载,两者不是同一层缓存。
解释三种启动表现
| 场景 | Vite 的主要动作 | 常见表现 |
|---|---|---|
| 首次启动或缓存失效 | 扫描依赖并执行预构建 | 启动时间略长,首次页面加载后趋于稳定 |
| 缓存有效的再次启动 | 复用 node_modules/.vite |
启动更快,依赖请求直接命中浏览器缓存 |
| 运行中发现新依赖 | 补充预构建并按需刷新页面 | 页面可能出现一次额外重载,之后恢复稳定 |
如果项目首次启动很快,但打开某个懒加载页面时突然重新优化,通常不是 HMR 失效,而是该页面引入的依赖没有在初始扫描阶段被发现。此时应先确认导入是否由动态路径或插件转换生成,再决定是否配置 optimizeDeps.include。
强制重新优化并验证
当你修改了链接依赖、怀疑缓存陈旧,或需要复现冷启动行为时,可以忽略现有优化缓存重新启动开发服务器。
npm run dev -- --force预期输出如下,版本、耗时和端口会因环境不同而变化。
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。