vite缓存机制以node_modules/.vite为核心，含依赖预构建与任务缓存双层结构；其智能失效基于锁文件、配置变更、源码修改及node_env切换；清理方式为删目录或--force启动，任务缓存需参数、环境变量、输入文件三者全匹配才命中。
Vite 的缓存机制主要围绕 node_modules/.vite 目录展开，它不是“一劳永逸”的静态缓存，而是带智能失效策略的构建中间产物存储区。清理和优化的关键在于理解它缓什么、何时失效、以及哪些操作真正触发重建。
缓存清理的两种有效方式
当修改依赖源码、打 patch、或发现依赖更新未生效时，手动干预缓存是必要操作：
-
直接删除
node_modules/.vite目录：这是最彻底的方式。Vite 启动时会自动重建该目录下的deps/（预构建依赖）、task-cache/（任务输出）和配置编译产物。删除后首次启动稍慢，但能确保干净起步。 -
使用
--force启动开发服务器：在package.json脚本中配置"dev": "vite --force"，可强制跳过依赖缓存复用，重新执行预构建流程。适合快速验证依赖变更是否被正确识别，无需删文件。
缓存何时自动失效（不用手动清）
Vite 并非依赖“时间戳”或“运气”来决定是否重建，它会主动比对多个关键信号：
-
包管理器锁文件变化：如
package-lock.json、yarn.lock或pnpm-lock.yaml内容有更新（版本号、解析路径等），缓存立即失效。 -
vite.config.*配置变更：包括resolve.alias、optimizeDeps相关字段、define注入项等，只要影响依赖解析或转换逻辑，就会触发重建。 -
依赖源文件被修改：比如你在
node_modules/lodash-es里改了某个函数，且项目中有patches文件夹（pnpm）或软链接指向本地源，Vite 会检测到其修改时间变化并刷新缓存。 -
NODE_ENV 变更：开发态与生产态对依赖的处理策略不同（如是否内联
process.env），环境变量切换也会导致缓存不复用。
任务缓存（node_modules/.vite/task-cache）的特别处理
如果你用 vp run 运行自定义任务（如生成类型、导出文档），它的缓存行为独立于依赖缓存：
- 缓存命中需同时满足三项：命令参数未变、指定的环境变量（
cache.env）未变、所有读取的输入文件（cache.inputs）内容未变。 - 任一不匹配即为 cache miss，Vite 会明确提示原因（例如 “env NODE_ENV changed” 或 “input src/env.ts modified”）。
- 如需跳过缓存直接重跑，加
--no-cache参数：vp run build --no-cache。
日常优化建议：少清、多控、防误伤
频繁手动清缓存反而降低效率。更可持续的做法是：
-
避免直接编辑
node_modules中的包：优先用patch（pnpm/yarn）、link或 fork +npm install xxx@file:../xxx方式管理本地修改，这样 Vite 更容易感知变更。 -
把常变动的配置抽离进函数式配置：例如根据
command和mode动态返回optimizeDeps.include，避免因配置硬编码导致缓存长期无效。 -
检查
.vite是否被 Git 忽略：它默认不在.gitignore中，但不应提交。确认项目根目录有/node_modules/.vite行，防止协作时缓存污染。
