冻结期的工具打磨：提升本地测试覆盖率
在软件工程中，很多开发者一听到“单测覆盖率”就感到头大，认为这是形式主义的 KPI 负担。但在实际的重大版本迭代与重构中，高覆盖率的核心链路单测，是保证改动代码不引入回归 Bug（Regression）的唯一安全绳。
在 v0.9 代码冻结期间，由于不再合入新功能，正是补齐核心逻辑测试用例的黄金时期。
利用现代轻量测试框架 Vitest，配合极速的本地覆盖率分析工具，我们仅用两天时间就将核心调度与降级链路的代码覆盖率从 62% 提升到了 94% 以上。
为什么选择 Vitest 替代传统 Jest
极简 Vitest 覆盖率配置
在 vitest.config.ts 中配置覆盖率统计阈值与排除路径：
import { defineConfig } from "vitest/config";
export default defineConfig({
test: {
globals: true,
environment: "node",
coverage: {
provider: "v8",
reporter: ["text", "json", "html"],
// 只关注核心业务与算法逻辑，排除纯类型声明与测试目录
include: ["src/core/**/*.ts", "src/services/**/*.ts"],
exclude: ["src/**/*.d.ts", "src/**/*.test.ts"],
// 设定强制门禁阈值：分支与行覆盖率必须达到 85%
thresholds: {
lines: 85,
functions: 85,
branches: 80,
statements: 85,
},
},
},
});
在 package.json 中配置运行命令：
{
"scripts": {
"test:coverage": "vitest run –coverage"
}
}
补齐单测的核心策略：抓大放小
追求 100% 的全局覆盖率是极其低效的。在有限的冻结期内，我们重点攻克三类高风险代码分支：
1. 复杂状态机与边缘异常分支
例如：当大模型返回损坏的 JSON 时，解析器是否能优雅修复？当网络超时中断时，熔断器计数器是否准确增加？
it("当模型返回末尾被截断的 JSON 时应自动补全闭合符号并成功解析", () => {
const truncatedJson = '{"intent":"search","params":{"keyword":"极简';
const result = autoFixJson(truncatedJson);
expect(result.intent).toBe("search");
});
2. 限流漏桶与滑动窗口算法
针对时间边界，使用 Vitest 内置的 vi.useFakeTimers() 模拟时间快进，毫秒级验证限流与 TTL 过期逻辑，无需真实等待 setTimeout。
3. 并发安全与连接池隔离
验证多协程或多异步任务并发读写 RingBuffer 时是否会出现数据竞争。
总结
单元测试不是为了应付检查，而是为了让自己在每次敲下 git push 和点击发版按钮时睡个好觉。
利用高效的工具把测试覆盖率拉高，让每一次重构都充满底气。
