Detekt静态分析工具中UtilityClassWithPublicConstructor规则的注解忽略配置

在Kotlin项目中使用Detekt进行代码静态分析时，UtilityClassWithPublicConstructor规则用于检测工具类（Utility Class）是否包含不必要的公共构造函数。这类工具类通常应该声明为object或者具有私有构造函数，以避免被意外实例化。

实际开发中会遇到特殊情况，比如使用测试框架时编写的特殊类。这类类需要保持class形式（而非object），且通常通过注解（如@Implements）标识其特殊用途。此时UtilityClassWithPublicConstructor规则会产生误报。

Detekt为此提供了灵活的配置选项：ignoreAnnotated参数。该参数允许开发者指定需要忽略的注解列表，当类被这些注解标记时，规则将跳过检查。配置示例如下：

UtilityClassWithPublicConstructor:
  active: true
  ignoreAnnotated:
    - org.robolectric.annotation.Implements
    - com.example.CustomAnnotation

这个配置机制体现了Detekt设计的重要理念：

1. 原则性与灵活性的平衡 - 在保持代码规范的同时允许合理例外
2. 注解驱动的扩展性 - 通过元数据标识特殊用例
3. 配置即文档 - 显式声明例外情况便于团队理解

对于测试相关的特殊类，这种配置特别有价值。它既保持了生产代码中工具类的规范要求，又允许测试代码保持其特定的组织结构。这种区分对待正是静态分析工具成熟度的体现。

在实际项目中，建议将这类框架特定的注解配置在共享的detekt配置文件中，确保团队所有成员都能受益于这些合理的例外规则。同时，也应该定期审查这些例外，确保它们仍然符合项目当前的架构规范。