SonarQube质量门如何设置 SonarQube质量门条件阈值配置

品牌型号：联想 E550C ThinkPad

系统：Windows 11

软件版本：SonarQube Server 25

SonarQube的质量门功能为我们提供了定义和强制执行代码质量标准的有效途径，它通过设置各项指标的合理检测阈值，帮助我们系统地检测代码质量并进行多项指标的量化评估，只有这些指标都符合预设标准，质量门才能顺利通过，从而确保交付的代码具备良好的可维护性、可靠性和安全性。在本文中，我们将一起学习SonarQube质量门如何设置，SonarQube质量门条件阈值配置，借助质量门为代码“保驾护航”。

一、SonarQube质量门如何设置

SonarQube质量门是评估项目代码质量好坏的一个重要功能，它通常包含多项指标条件，如代码测试覆盖率、重复代码占比、新问题数量、安全漏洞数量等。当项目分析完成后，SonarQube会根据预设条件判断这些指标是否全部通过，如全部通过则给出“通过”的结果，否则为“失败”。下面是设置质量门的步骤：

1、使用管理员账号登录SonarQube网页端，进入页面后，点击上方的“Quality Gates”菜单，我们便能看到系统提供的默认质量门和自定义质量门列表。

2、默认质量门不可编辑，如果要采用自己的质量门设置，可以点击“Create”按钮创建一个质量门，并输入质量门名称。

3、创建后质量门默认会配置四个条件，分别是问题数量等于0、安全漏洞查阅比例等于100%、测试覆盖率高于80%、重复代码率低于3%，只有这四个条件都符合才算质量门通过。

如要修改条件，可以点击“Unlock editing”按钮，将表单变为编辑状态。

4、编辑状态下，点击条件右侧的“铅笔”图标可以对条件的Value值进行修改，点击“垃圾桶”图标可以删除该条件。

点击“Add Condition”按钮，选择一个指标并填写Value值，可以新增一个条件。

二、SonarQube质量门条件阈值配置

配置质量门条件阈值是质量门设置的关键环节，每个条件都需要设置一个阈值，当项目分析结果超过或不及这个阈值时，质量门便会出现Failed的结果，因此阈值是决定代码质量好坏的重中之重，需要一定的配置经验进行配置。

在新增条件时，需要填写Value值，这个就是条件阈值，可选范围从0到100。

1、对于严重及以上级别的安全漏洞和BUG Issues，建议设置阈值为0，确保代码没有明显的质量问题。

2、对于新代码的测试覆盖率，建议设置阈值为80，确保新增代码有足够的测试用例覆盖，不会出现意料之外的问题。

3、对于重复代码比例，根据多数项目的经验比例，建议设置阈值为5%，以控制代码重复率，确保项目新代码有较高的可维护性。

配置SonarQube质量门条件和阈值，需要理论与实践相结合，根据自身项目的特性和参考过往的设置，总结出最适合自己的条件阈值，质量门的价值并不在于设置多么严格的标准查出很多的问题，而在于能否持续推动代码质量的提升。以上就是关于SonarQube质量门如何设置，SonarQube质量门条件阈值配置的教程，希望本文的内容能帮助我们在日常开发中更好地利用SonarQube这一工具，构建更加可靠的软件系统。