Kotlin中Detekt的LibraryEntitiesShouldNotBePublic规则作用是什么？

首先纠正一个关键误解：这个规则不是禁止所有公共类，而是禁止不必要的public修饰——它的核心目的是引导库开发者遵循「最小暴露原则」，避免把内部实现细节无差别地对外暴露。

为什么会有这个规则？ #

Kotlin和Java的默认可见性差异是核心原因：

• Java中类/成员默认是包级私有，要跨包访问必须显式加public；
• Kotlin中类/成员默认是internal（模块内可见，比如你的整个Gradle库模块），不需要显式声明。

从Java转Kotlin的开发者很容易保留旧习惯，给所有类都加public，导致原本只需要内部使用的工具类、辅助数据类也被暴露给库的使用者。这会带来两个问题：

1. 使用者可能会依赖这些内部细节，后续你修改库的内部实现时就会破坏兼容性；
2. 对外暴露的API变得臃肿，使用者很难快速找到真正有用的功能。

正确的做法是什么？ #

只给对外提供服务的核心API添加public修饰，内部实现类/函数保持默认的internal即可：

// 对外暴露的核心类，必须显式加public
public class ImageProcessor {
    public fun processImage(path: String): Bitmap {
        // 调用内部实现类
        val decoder = InternalImageDecoder()
        return decoder.decode(path)
    }
}

// 内部解码工具类，默认internal，仅库模块内可见
class InternalImageDecoder {
    fun decode(path: String): Bitmap {
        // 内部实现逻辑
    }
}

这样既符合Detekt规则的要求，又能保证库的可用性——使用者依然可以通过ImageProcessor这个公共类使用你的库功能，同时无法访问到内部的InternalImageDecoder，避免了不必要的依赖。

总结 #

这个规则的本质是帮你做好库的API边界设计，而不是让你做一个没有公共类的无用库。检查你的代码，把那些仅内部使用的类的public修饰符去掉，只保留对外暴露的核心API为public即可解决问题。

内容的提问来源于stack exchange，提问作者ali