vitest

Vitest

仓库配置、项目、设置、导入/全局变量、环境、别名、测试文件位置和清理规则共同构成测试约定。添加通用模式前，请先检查这些内容及附近的测试。默认不要添加全局变量、jsdom、覆盖率、新设置或浏览器模式。

工作流

明确行为或回归问题。测试其可观察的公开结果。模拟系统边界，而不是被测行为。遵循本地 fixture 和清理规则的归属。在 Effect 仓库中，使用既定的 @effect/vitest 约定，例如 it.effect、Layers 和 TestClock，而不是通用替代方案。修复 Bug 时，条件允许的话，应先复现故障，再依赖通过的结果。

遇到组件、异步、fixture、快照、标签或浏览器相关问题，请阅读模式。遇到模块、计时器、spy 或全局边界相关问题，请阅读模拟。遇到项目、迁移、覆盖率或报告器选择相关问题，请阅读配置。遇到挂起、测试发现、解析或状态不稳定问题，请阅读故障排查。

对于测试变更，先运行针对所改行为的最小范围既定命令；只有在共享设置或约定发生变化时，才运行受影响的程序包测试套件。仅当不存在项目配方或脚本时，才使用 nlx vitest run。如果没有新增修改、失败或未解决的问题需要再次运行，请复用已通过的结果。

完成时，必须在仓库配置下通过有意义的聚焦测试，并为测试变更提供简洁的命令和结果证据。只读说明则需要提供配置或 API 方面的依据。不要仅为满足变更工作流而添加或运行测试。存在先失败后通过的证据时，请使用 ### 🧪 Regression covered。否则，对已执行的测试使用 ### 🧪 Tests verified。