开发Kotlin库时，使用Object还是Class更合适？

核心结论 #

当前场景下使用 Object 并不是不合适的方案，选型优先取决于你的库的定位和长期规划： #

适合保留 Object 实现的情况 #

如果你的库符合以下特征，完全可以继续用 Object 方案：

• 全局仅需要一个采集实例：绝大多数数据采集类库的使用场景都是全局统一上报，不需要多实例隔离，Kotlin Object 天然实现的线程安全单例刚好匹配需求，无需额外手写单例逻辑
• 优先降低用户接入成本：Object 无需用户手动创建、持有实例，你的现有链式初始化 API MyLibrary.setThings(myParameters).setEnabled(true).init() 足够简洁，用户学习成本更低
• 内部模块调用便捷：你当前内部使用的 internal object LoggingModule 仅对内可见，不会对外暴露耦合，内部调用不需要传递实例，开发效率更高

建议切换为 Class 实现的情况 #

如果你的库有以下规划，更推荐用 Class 实现：

• 后续要支持多实例需求：比如需要允许用户同时向两个不同的后台上报数据，或者不同业务模块的采集数据完全隔离，Object 的全局单例特性会直接限制这个能力
• 需要兼容依赖注入场景：如果要给用户提供支持 Hilt/Dagger 等 DI 框架的能力，Class 更方便用户自定义实例生命周期、替换实现，而 Object 硬编码的全局单例灵活性不足
• 对单元测试友好性要求高：Class 可以在每次测试时新建实例，无需处理单例的状态残留问题，而 Object 要支持测试需要额外编写重置状态的内部方法，增加维护成本

折中方案参考 #

如果不确定后续需求，可以对外同时提供两种能力：

1. 对外暴露可实例化的 MyLibrary Class，供有自定义需求的用户使用
2. 内部保留一个全局的 Object 单例实例，对外提供默认的链式调用 API，兼顾普通用户的易用性

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