质量门禁Quality Gate
你可能会说
为什么我刚提交的代码合并不了,AI 提示我‘质量门禁未通过’?
在合并代码或发布版本前,根据检查结果判断是否允许继续的一组准入条件例如测试全部通过,但覆盖率没有达到团队约定的 80%,这次改动仍不能合并。检查负责产出结果,门禁负责判定;还要把它设为必需检查,代码平台才会据此阻止合并。
也常被叫作Quality Gates代码门禁发布门禁PR 门禁CI 门禁
为什么测试全过,PR 还是不能合并
必需检查质量门禁
单元测试✓ 45 / 45
Lint✓ 0 错误
覆盖率 · 要求 ≥ 80%× 68%
合并操作等待覆盖率达标
45 个测试都通过,但覆盖率 68% 低于约定的 80%,所以必需检查仍失败。
检查结果怎样变成合并条件
先约定标准,再接入阻断:团队根据项目风险设置标准,例如关键测试通过、无严重安全问题。持续集成 CI 运行检查;把门禁结果设为分支保护中的必需检查,才能自动拦住未达标的合并。
失败后改哪里,要看报告:覆盖率不足就检查未覆盖路径,测试失败就查看实际结果与预期的差异。重复运行相同代码或降低标准,不能证明原来的问题已经解决。
你可以这样告诉 AI Agent
这个 PR 的质量门禁没通过。请查看失败报告,定位缺失的测试或代码问题,修复后重新检查,确认原来的门禁标准已经满足。
接下来学什么
延伸阅读 · 权威出处
快速练习
PR 的 45 个测试都通过,但报告显示覆盖率 68%,要求至少 80%。下一步怎样做?
ANS 原创方法