用途:为编写隔离、快速、可维护的单元测试提供一套可组合的规则、参考与脚手架,适用于 TypeScript 与 Python 项目。
主要能力与结构:围绕三类内容组织——单元测试结构(AAA 模式、fixture scoping、参数化)、HTTP mocking(MSW 2.x、VCR.py)、测试数据管理(工厂、fixture、播种与清理)。共 8 条规则、4 份参考、3 份检查表、1 组示例、3 个脚本,规则文件位于 rules/ 下按需加载。
核心实践:每个测试遵循 Arrange-Act-Assert;多输入用 test.each 或 @pytest.mark.parametrize 而非复制粘贴;可变数据用默认 scope=function,module/session 仅用于昂贵只读资源;单测目标 100ms 以内;HTTP 在网络层用 MSW 或 VCR.py 拦截,不直接 mock fetch/axios/requests;测试数据优先用工厂(FactoryBoy / @faker-js)。
使用方式:按需打开对应 rule 文件,配合 reference、checklist 与脚本使用。脚本包括创建测试用例、pytest fixture、MSW handler 的脚手架。快速开始示例涵盖 Vitest + MSW 的纯单测与 API mock 测试,以及 pytest + FactoryBoy 的参数化与权限测试。Vitest 4.1 涉及 aroundEach/aroundAll、mockThrow/mockThrowOnce、vi.defineHelper、test tags、Agent Reporter 等特性。
适用场景:前端或后端业务逻辑的单测设计、API 调用 mock、测试数据构造与清理、CI 中按标签筛选测试。
限制与常见错误:避免测试实现细节、直接 mock fetch/axios、模块级可变共享状态、硬编码重复数据、播种后不清理、过度 mock、冗长 throw mock。资料中未提供安装命令、定价或平台要求等信息,暂未提供。