Kotlin 中如何将类作为参数传递

1. 引言

在 Kotlin 中，类是语言的核心组成部分，我们用它来定义对象及其行为。虽然日常开发中传递基本类型或对象参数很常见，但在某些场景下，我们需要把类本身当作参数传给函数。

这种“传类”的能力在依赖注入、反射实例化、动态工厂模式等场景中非常实用。本文将系统讲解在 Kotlin 中如何安全、高效地实现类的传递，并对比不同方式的适用场景和踩坑点 ✅

2. 使用类引用（Class Reference）

Kotlin 提供了两种类引用方式：KClass 和 Java 的 Class。它们都能表示一个类的元信息，但使用场景和功能略有差异。

2.1 KClass 与 Class 的区别

MyClass::class → 返回 Kotlin 的 KClass<MyClass>
MyClass::class.java → 转换为 JVM 的 Class<MyClass>

✅ 核心区别：

KClass 是 Kotlin 原生支持的类引用，能更好地处理泛型、可空类型等 Kotlin 特性
Class 来自 Java 反射体系，主要用于与 Java 代码互操作（interop）
如果你在纯 Kotlin 环境下工作，优先使用 KClass
需要调用 Java 反射 API 时，再转成 .java

⚠️ 注意：不要混淆 ::class 和 .class —— 后者是 Java 语法，在 Kotlin 中无效！

2.2 使用 Class 参数接收类引用

先定义一个测试类：

class ParameterClass {
    fun parameterClassMethod(): String {
        return "This is a method called on our class"
    }
}

接下来写一个接受 Class<T> 类型参数的函数：

fun <T : ParameterClass> functionAcceptingClassReference(clazz: Class<T>): String {
    val instance = clazz.newInstance()
    return instance.parameterClassMethod()
}

📌 关键点解析：

泛型约束 <T : ParameterClass> 确保传入的类必须继承自 ParameterClass
clazz.newInstance() 利用 Java 反射创建实例（要求类有无参构造函数）
❌ 注意：从 Android API 26+ 开始，newInstance() 已被标记为废弃，推荐使用 getDeclaredConstructor().newInstance()

测试用例：

@Test
fun `passes class as function parameter using class reference`() {
    val result = functionAcceptingClassReference(ParameterClass::class.java)
    assertEquals("This is a method called on our class", result)
}

2.3 使用 KClass 参数接收类引用

换成 KClass 写法更简洁且类型安全更强：

fun <T : ParameterClass> functionAcceptingKClassReference(clazz: KClass<T>): String {
    val instance = clazz.createInstance()
    return instance.parameterClassMethod()
}

📌 核心优势：

createInstance() 是 KClass 提供的方法，专为 Kotlin 设计
自动检查是否存在无参构造函数，失败时抛出清晰异常
更好地支持内联类、密封类等 Kotlin 特性

测试代码：

@Test
fun `passes class as function parameter using kclass reference`() {
    val result = functionAcceptingKClassReference(ParameterClass::class)
    assertEquals("This is a method called on our class", result)
}

✅ 推荐：在纯 Kotlin 项目中优先使用 KClass + createInstance() 组合

3. 使用 reified 类型参数

当函数是 inline 的时候，可以用 reified 关键字让泛型在运行时可见，从而避免显式传参。

inline fun <reified T : ParameterClass> functionAcceptingClassNameUsingReifiedParameters(): String {
    val instance = T::class.java.newInstance()
    return instance.parameterClassMethod()
}

📌 核心机制：

reified 必须配合 inline 使用
编译器会在调用处“展开”泛型类型，因此可以拿到真实的 Class 对象
调用时无需传类引用，直接指定泛型即可

测试示例：

@Test
fun `passes class as function parameter using reified parameters`() {
    val result = functionAcceptingClassNameUsingReifiedParameters<ParameterClass>()
    assertEquals("This is a method called on our class", result)
}

✅ 优点：

调用更简洁，API 更优雅
避免手动传 ::class 或字符串类名

❌ 缺点：

只能在 inline 函数中使用
过度使用可能导致字节码膨胀

💡 典型应用场景：ViewModel 工厂、Gson TypeToken 封装、DSL 构建器等

4. 使用 Java 反射通过类名字符串创建实例

最后一种方式是传类的全限定名（FQN），然后通过 Class.forName() 动态加载：

fun <T : ParameterClass> functionAcceptingClassNameUsingReflection(className: String): String {
    val clazz = Class.forName(className) as Class<T>
    val instance = clazz.newInstance()
    return instance.parameterClassMethod()
}

📌 使用要点：

className 必须包含包路径，例如 "com.example.ParameterClass"
Class.forName() 会触发类加载，若类不存在则抛 ClassNotFoundException
强制转换使用 as Class<T>，存在运行时风险，建议加 try-catch

测试代码：

@Test
fun `passes class as function parameter using reflection`() {
    val result = functionAcceptingClassNameUsingReflection<ParameterClass>("com.baeldung.classParameterToFunction.ParameterClass")
    assertEquals("This is a method called on our class", result)
}

⚠️ 踩坑提醒：

包名拼错、类未编译都会导致运行时报错
混淆（ProGuard/R8）后类名可能变化，慎用于生产环境
newInstance() 同样面临废弃问题，建议升级为：

val constructor = clazz.getDeclaredConstructor()
constructor.newInstance()

✅ 适用场景：

插件化架构
配置驱动的类加载（如 SPI）
序列化框架反序列化入口

5. 总结

方式	是否类型安全	是否需无参构造	推荐程度	典型用途
`Class<T>`	✅ 是	✅ 是	⭐⭐☆	Java 互操作
`KClass<T>`	✅✅ 最佳	✅ 是	⭐⭐⭐	纯 Kotlin 场景
`reified`	✅✅ 编译期推导	✅ 是	⭐⭐⭐	inline 函数封装
`Class.forName()`	❌ 字符串不安全	✅ 是	⭐☆	动态加载、插件系统

✅ 最佳实践建议：

日常开发首选 KClass + createInstance()
封装通用逻辑时考虑 reified inline
只有在需要动态加载类名时才用 Class.forName()
所有反射操作都应做好异常处理（NoSuchMethodException、InstantiationException 等）

合理选择传类方式，不仅能提升代码安全性，还能显著增强扩展性和可维护性。别再硬编码 new 实例了，试试这些更灵活的设计吧 💡

Persistence

REST

Security