Qoder 在生成接口代码之后，建议立即进行一次契约一致性校验。可先执行 qoder init --test，完成测试环境初始化并自动安装所需依赖。需要特别留意的是，Qoder 目前只识别 TypeScript 测试文件，命名格式限定为 .spec.ts、.test.ts、__tests__/*/.ts；在执行测试时，既支持指定单个文件，也支持使用 glob 模式批量运行。排查报错或定位问题时，可以加上 --debug 参数；如果需要生成测试覆盖率报告，则使用 --coverage。

Qoder 生成接口代码后，最好第一时间验证接口行为是否满足契约要求，否则在后续联调或系统集成阶段，可能因为参数校验不通过、HTTP 状态码不正确，或响应数据结构不一致而引发连锁故障。

确认测试环境已就绪

进入项目根目录后，执行 qoder init --test。该命令会自动创建 __tests__ 目录、生成 jest.config.js（如果当前项目中尚不存在），并安装 @qoder/test-utils 依赖包，帮助你快速搭建 Qoder 接口测试环境。

如果项目已经存在 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。

运行接口测试

方法一：通过相对路径指定单个测试文件
执行 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 目录影响最终覆盖率数据，使接口测试覆盖率结果更准确。