前端工程化 / 系统课时
治理缓存与启动性能
治理缓存与启动性能
本课解决“删了缓存却没有变化”和“启动偶尔变慢”两类问题。你将先确认真实 cacheDir,再区分文件系统缓存、浏览器缓存与插件转换开销,并用冷启动、热启动和强制优化三组结果判断瓶颈。
学习目标
- 正确定位并清理 Vite 实际使用的缓存目录
- 区分正常缓存命中、强制依赖优化和浏览器缓存影响
- 使用统一命令、日志与启动耗时验证优化是否生效
先确认清理对象
Vite 的 cacheDir 用于保存预打包依赖及其他缓存文件;存在 package.json 时默认是 node_modules/.vite,但项目可以改成任意相对或绝对路径。清理前先搜索 vite.config.* 中的 cacheDir,并确认启动命令使用的 root 和配置文件,避免删错工作区或只清理了仓库根目录。:contentReference[oaicite:3]{index=3}
缓存问题至少分三层:Vite 文件系统缓存决定依赖是否重新优化;浏览器会长期缓存已优化依赖请求;插件和源码转换还会形成进程内或文件缓存。只删除 node_modules/.vite,不会自动清除浏览器缓存,也不会修复一个每次启动都执行昂贵任务的插件。
按最小范围清理缓存
先停止全部 Vite 进程,再删除当前项目真实的 cacheDir。不要把删除整个 node_modules 当成第一步,因为那会同时引入重新安装依赖、脚本执行和锁文件变化,反而污染对比结果。
rm -rf node_modules/.vite
npm run dev -- --force --debug预期输出:
VITE v<MAJOR>.<MINOR>.<PATCH> ready in <MS> ms
Local: http://localhost:<PORT>/
<DEBUG_LOGS_ABOUT_DEPENDENCY_OPTIMIZATION>--force 会忽略已有优化结果并重新处理依赖;手动删除 cacheDir 也会使缓存重新生成。两者用于一次性验证即可,不应长期写进默认开发脚本,否则每次启动都会失去缓存收益。:contentReference[oaicite:4]{index=4}
如果项目自定义了目录,例如 cacheDir: '.cache/vite',应删除该目录而不是默认路径。Windows PowerShell 可使用 Remove-Item -Recurse -Force <PATH>,其中 <PATH> 替换为解析后的真实缓存目录。
用三组启动结果判断是否失效
采用同一 Node.js 版本、同一依赖锁文件、同一端口和同一访问页面,连续记录三组 ready in <MS> ms:第一次删除缓存后启动,记为冷启动;第二次不改文件直接重启,记为热启动;第三次使用 --force,记为强制优化。
热启动明显快于冷启动,说明文件系统缓存正在命中;强制优化接近冷启动,说明 --force 确实绕过了已有优化结果。三组都慢时,不要继续反复删缓存,应转查插件初始化、配置加载、网络文件系统和依赖扫描。单次耗时容易受 CPU、磁盘和杀毒软件影响,至少重复三轮并比较中位数。
判断缓存为什么没有失效
Vite 会依据依赖锁文件、相关配置、环境值等信息决定是否重新预打包;仅修改依赖源码或链接包而没有改变这些输入时,旧优化结果可能继续使用。需要验证本地依赖修改时,依次执行:关闭开发服务器、使用 --force 重启、在浏览器 Network 面板临时禁用缓存并重新加载。已优化依赖使用强缓存,浏览器层未刷新时会造成“服务端已经重建,页面仍像旧版本”的错觉。:contentReference[oaicite:5]{index=5}
反过来,日常开发不应长期勾选开发者工具的 Disable Cache。Vite 对预打包依赖使用强缓存,对源码请求利用快速的条件响应;持续禁用浏览器缓存会放大启动后首次加载和整页刷新的耗时。:contentReference[oaicite:6]{index=6}
继续定位真正的启动瓶颈
缓存命中正常但启动仍慢时,启用插件转换日志,定位耗时集中在哪个插件或文件:
npm run dev -- --debug plugin-transform预期输出:
<DEBUG_PREFIX> plugin-transform <DURATION>ms <PLUGIN_NAME> <PATH>异步插件的单条计时只能作为近似值,但足以帮助发现持续偏慢的转换。优先检查社区插件的 config、configResolved、buildStart、resolveId、load 和 transform 钩子,避免在每个模块请求中执行无条件解析、磁盘扫描或同步网络访问。官方性能指南也建议使用 vite --debug plugin-transform 检查转换耗时。:contentReference[oaicite:7]{index=7}