我的经验(自 SQ 在 3 家不同的公司首次发布以来,我一直在使用它,多年来编写了 130 多份自定义检查)如下:
- 创建作为当前“SonarQube Way”配置文件副本的配置文件 P1
- 在此配置文件中删除所有与您的上下文无关的规则(主要是如果您有一个与现成规则冲突的自定义规则)并在需要时更改优先级(仅在您的上下文需要时尝试增加优先级。)跟踪修改配置文件的原因。这里的重点是能够说“我们遵循现成的配置,除了一些我们想要更严格控制的特定情况”。此配置文件将用于轻松将您当前的“SonarQube Way”配置文件与新的配置文件进行比较。
- 创建一个从 P1 继承的配置文件 P2 并添加其他规则,无论它们是否自定义。与您的开发团队一起讨论这个主题,以达成共识。
- 尽可能保留您添加的规则的默认优先级(不要给那些想争论您的配置有缺陷的人提供食物,如果您需要更改优先级,请准备好捍卫您的决定,请参阅下一个点。)
- 对于所有规则优先级更改(现成和/或自定义规则),请遵循预定义的比例(例如 this one)并坚持下去。
- 将 P2 设为默认配置文件。
那么每次“SonarQube Way”进化时,你都可以轻松更新它,然后与P1进行比较。
您可以使用“SonarQube Way with Findbugs”配置文件执行完全相同的操作(但我不会这样做,因为这会启用很多规则...)
请始终牢记,您可以解释的规则越少越好,并且所有开发人员都愿意申请,而不是有很多难以解释的检查,没人相信,没人想申请,也不想再阅读 SQ,因为到巨额支票。换句话说,从小处着手,与您的开发者同行一起成长。
还请记住,未解决的问题(并且没有人愿意解决,因为他的统治会引发太多误报,难以理解等)是难以摆脱的债务。这是一个总是会带来更多债务的泄漏,主要是因为人们还没有准备好听到这些问题。在这种情况下,最好停用这些规则,然后在人们准备好谈论它们并应用它们时再将它们带回来。
最后但并非最不重要。就质量配置文件的发布日期与开发团队达成一致。例如,假设您同意每年将有两次个人资料更新这一事实。在两个配置文件发布之间,欢迎人们讨论规则,但这些规则要到下一个版本才能修改,如果需要修改(添加/删除规则),必须讨论并达成共识。如果一个项目在两个版本之间开始,它会从当前配置文件开始并使用它。当配置文件更新时,您的项目可能有一个版本来使其代码与新规则保持一致,或者如果您使用“修复泄漏”方法,项目同意新代码以及重构代码将遵循新配置文件。
请记住,如果您是配置文件的所有者,您的开发人员应该是要求添加新规则的人(顺便说一下,这是一个很好的 KPI。)
关于这一点还有很多话要说,但这应该是一个很好的起点,以便为您提供帮助。