Vitest项目中cacheDir配置失效问题的技术解析

问题背景

在Vitest测试框架中，当开发者配置了Vite的cacheDir选项并同时启用了依赖优化器(deps.optimizer.{mode}.enabled)时，会出现缓存目录配置失效的问题。具体表现为：即使明确指定了cacheDir路径，Vitest仍会将缓存文件写入默认的node_modules/.vite目录，而非开发者指定的路径。

技术原理分析

Vitest作为基于Vite的测试框架，继承了Vite的缓存机制。缓存目录的配置本应遵循以下层级关系：

1. Vite基础配置：cacheDir是Vite的核心配置项，用于指定所有缓存文件的存储位置
2. Vitest扩展配置：Vitest在此基础上增加了cache.dir和server.deps.cacheDir等扩展配置
3. 依赖优化器：当启用依赖优化时(deps.optimizer.{mode}.enabled)，Vitest会创建专门的优化依赖缓存

在理想情况下，这些配置应该协同工作，最终缓存路径应为：${cacheDir}/vitest。然而当前实现中存在一个缺陷：当依赖优化器启用时，代码中硬编码了node_modules/.vite路径，而忽略了用户配置的cacheDir。

影响范围

这个问题主要影响以下使用场景的开发者和项目：

1. 希望自定义缓存目录位置的项目（如希望将缓存放在项目根目录而非node_modules）
2. 同时使用依赖优化功能的测试套件
3. 需要严格控制构建产物位置的环境（如某些CI/CD流水线）

解决方案

从技术实现角度看，修复此问题需要修改Vitest处理缓存目录的逻辑，确保：

1. 优先尊重用户显式配置的cacheDir
2. 当未明确配置时，才回退到默认的node_modules/.vite
3. 对于Vitest特有的缓存，应在基础缓存目录下创建vitest子目录

正确的路径解析逻辑应该类似于：

const finalCacheDir = cache.dir ?? join(cacheDir, "vitest")

最佳实践建议

在等待官方修复的同时，开发者可以采用以下临时解决方案：

1. 使用已被标记为废弃但当前能正常工作的cache.dir选项
2. 在项目根目录创建指向自定义缓存目录的符号链接（仅适用于Unix-like系统）
3. 在测试脚本中添加环境变量覆盖缓存路径

总结

缓存目录配置是构建工具和测试框架中的重要功能，它影响着构建性能、开发体验和项目可维护性。Vitest作为Vite生态中的重要组成部分，其配置继承和扩展机制需要保持一致性。这个问题虽然不会影响核心功能，但对于有特定目录结构要求的项目来说，仍然值得关注和修复。