1. @JvmName 注解的作用
@JvmName 是 Kotlin 提供的一個注解，用于在編譯為 Java 字節碼時自定義生成的類名或方法名。
-
作用對象：
- 文件級別（整個
.kt文件） - 函數、屬性、類等成員
- 文件級別（整個
-
主要用途：
- 控制 Kotlin 編譯后生成的 JVM 類名和方法名。
- 避免與 Java 的命名沖突。
- 提高 Java 調用 Kotlin 代碼時的可讀性和一致性。
2. 使用場景
? 場景 1：修改 Kotlin 文件對應的 JVM 類名
Kotlin 默認會將文件 FileName.kt 編譯成 FileNameKt.class。
使用 @file:JvmName("CustomName") 可以指定生成的類名為 CustomName.class。
@file:JvmName("Stu")
package com.mayh.kotlindemo.kt_step7.kt_annotaionfun getStudentInfo(name: String) {println(name)
}
編譯后生成的類名為：
Stu.class
? 場景 2：修改 Kotlin 函數在 JVM 中的方法名
可以給某個函數添加 @JvmName("customMethodName")，使其在 Java 中調用時使用指定名稱。
@JvmName("getSt")
fun getStudentInfo(studentName: String) = println(studentName)
編譯后生成的方法名為：
public static final void getSt(String studentName)
? 場景 3：解決 Java 調用多個同名 Kotlin 文件函數沖突
當多個 Kotlin 文件包含相同包名下的同名頂層函數時，Java 調用可能會沖突。
通過 @file:JvmName 修改生成的類名即可避免沖突。
? 場景 4：與 @JvmOverloads 或 @JvmField 等配合使用
在混編項目中，結合其他 JVM 相關注解，統一 Kotlin 和 Java 的接口風格。
3. 注意事項
| 注意點 | 說明 |
|---|---|
| 不能重載 by name only | 如果兩個函數僅通過 @JvmName 改變名字導致簽名相同，會編譯報錯。 |
| 避免與 Java 關鍵字沖突 | 如命名成 Int, String 等會導致錯誤。 |
| 對擴展函數也有效 | 可以為擴展函數指定 JVM 名稱，便于 Java 調用。 |
4. 總結
| 功能 | 描述 |
|---|---|
| @JvmName on file | 指定整個 Kotlin 文件編譯后的類名 |
| @JvmName on function/property | 指定該方法/屬性在 JVM 中的名稱 |
| 適用場景 | Java/Kotlin 混合項目、避免命名沖突、提升可讀性 |
| 推薦使用方式 | 在需要被 Java 調用的工具類、頂層函數中使用 |
在 Android 開發或 Java/Kotlin 混合項目中，合理使用
@JvmName可以讓 Kotlin 更好地兼容 Java，提高代碼的可維護性和交互性。
)
