Qoder生成接口代码后需立即验证契约合规性，执行qoder init --test初始化测试环境并安装依赖，仅识别.spec.ts/.test.ts/__/tests__/*/.ts格式的TypeScript测试文件，支持单文件或glob模式运行，调试时加--debug，覆盖率报告通过--coverage生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder生成接口代码后需要立即验证其行为是否符合契约，否则后续集成可能因参数校验失败、状态码错误或响应结构偏差导致级联故障。
确认测试环境已就绪
进入项目根目录，执行 qoder init --test。该命令会自动创建 __tests__ 目录、生成 jest.config.js（若不存在）并安装 @qoder/test-utils 依赖包。
如果项目已有 Jest 配置但未适配 Qoder 运行时，此命令会备份原配置为 jest.config.js.bak，并注入 setupFilesAfterEnv 和 testEnvironment 字段——【缺少这两个字段将导致测试无法加载 Qoder 提供的 mock 工具链】。
编写可被识别的测试文件
Qoder 仅识别以下任一命名模式的 TypeScript 测试文件：*.spec.ts、*.test.ts、__tests__/**/*.ts。
不支持 .js 后缀的测试文件，即使配置了 transform 也不会被加载——【Qoder 测试运行器强制要求 TypeScript 源码】。
合法路径示例：src/api/user.spec.ts、__tests__/v1/auth.test.ts。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
运行接口测试
方法一：使用相对路径指定单个测试文件
执行 qoder test src/api/user.spec.ts，直接运行该文件内所有 describe 和 it 块。
方法二：使用 glob 匹配多个接口测试
执行 qoder test "__tests__/v1/**/*"，注意双引号包裹 glob 表达式，否则 shell 可能提前展开导致路径错误。
调试与覆盖率报告
第一步：启用调试模式
添加 --debug 参数，例如 qoder test --debug src/api/user.spec.ts，此时会输出 V8 inspector 地址，可在 Chrome DevTools 中附加调试。
第二步：生成覆盖率报告
执行 qoder test --coverage，覆盖率结果默认输出至 coverage/lcov-report/index.html；若需同时输出文本摘要，追加 --coverageReporters=text-summary。
第三步：排除非业务代码
在 jest.config.js 中配置 collectCoverageFrom 字段，明确限定只统计 src/**/*.{ts,tsx}，避免 __mocks__ 或 types 目录干扰覆盖率数值。
