多语言测试框架速查手册

纯文档型测试框架指南，涵盖 Vitest、Jest、pytest、Playwright 等主流工具，帮助开发者快速搭建多语言测试体系，提升代码质量与交付信心。

基本信息

• 技能名称?test-runner
• 中文名称?多语言测试框架速查手册
• 作者?cmanfre7
• 分类?开发
• 版本?v1.0.0
• 标签?testing, development-engineering, productivity, docs, automation

使用方法

使用说明
核心用法
test-runner 是一款纯文档型 Skill，专注于为开发者提供跨语言、跨框架的测试编写与运行指南。其核心内容覆盖 TypeScript/JavaScript（Vitest、Jest、Playwright）、Python（pytest）、Swift（XCTest）三大主流技术栈，从单元测试、集成测试到端到端（E2E）测试形成完整闭环。Skill 内置 TDD（测试驱动开发）工作流图解，以及 Arrange-Act-Assert、Mocking、异步测试等经典模式示例，开发者可直接复制配置代码和命令快速启动项目测试体系。
显著优点

1. 多语言一站式覆盖 ：无需切换多个文档，单点获取 JS/TS、Python、Swift 的测试方案，降低团队技术栈迁移成本。
2. 实战导向的配置模板 ：提供可直接运行的 vitest.config.ts 、 、 pytest` 命令行参数、Playwright 项目配置等，减少从零摸索时间。
3. 测试策略清晰 ：明确区分"Always test"与"Don't bother"清单，帮助团队聚焦高价值测试场景，避免过度测试或测试遗漏。
4. 覆盖率工具链完整 ：集成 v8、istanbul、pytest-cov 等主流覆盖率方案，并附 HTML 报告查看命令，便于质量门禁建设。
   潜在缺点与局限性
5. 无自动化执行能力 ：Skill 仅提供文档参考，所有命令需用户手动输入，无法直接触发测试运行或结果解析。
6. 框架版本锁定风险 ：示例代码基于特定版本（如 Vitest、pytest），若用户环境版本差异较大，可能出现配置不兼容。
7. 缺乏 CI/CD 集成指导 ：未涉及 GitHub Actions、Jenkins 等流水线配置，团队需额外补充持续集成方案。
8. 无项目结构建议 ：未说明测试目录组织规范（如 tests vs tests// ），大型项目可能面临目录混乱。
   适合的目标群体
   全栈开发者 ：需要在同一项目中处理前后端多语言测试的工程师。
   技术负责人 ：为团队制定测试规范、选型测试框架的架构师。
   测试新手 ：希望系统学习 TDD 流程和测试模式、快速上手的初级开发者。
   开源维护者 ：需要为项目补充测试覆盖率、提升代码可信度的仓库所有者。
   使用风险
   环境依赖风险 ：示例命令依赖 Node.js、Python、Swift 等运行时环境，若用户未安装或版本不匹配，命令将执行失败。
   配置覆盖风险 ：直接复制配置文件可能覆盖现有项目配置，建议先备份或 diff 对比。
   覆盖率阈值误导 ： --cov-fail-under=80 等参数若未结合项目实际，可能导致 CI 频繁失败或虚假安全感。
   Mock 误用风险 ：示例中的 vi.stubGlobal 等全局替换操作，若未在 teardown 中恢复，可能污染后续测试用例。