Kotlin中@JvmSynthetic注解作用于文件的用途是什么？

我原本想用文件级@JvmSynthetic注解隐藏包含大量Kotlin专属扩展方法的文件，避免Java用户可见，但实际效果不符合预期：

Kotlin代码示例 #

// Extensions.kt

@file:JvmSynthetic

@JvmSynthetic
fun Foo.mySyntheticExtension() = ...
fun Foo.myExtension() = ...

Java调用示例 #

// Java 用法

// 无法编译（符合预期）
Extensions.mySyntheticExtension(foo);

// 可正常编译，说明文件级@JvmSynthetic不会传递给所有函数
Extensions.myExtension(foo);

即使文件里没有非合成方法，Java用户仍会看到生成的ExtensionsKt类（虽为空）。既然文件级@JvmSynthetic既不隐藏生成类，也不传递合成状态给所有函数，它的预期用途是什么？

文件级@JvmSynthetic的核心用途 #

文件级@JvmSynthetic的作用范围仅限编译器自动生成的辅助代码，而非你手动编写的顶层成员，具体用途包括：

• 标记编译器生成的辅助元素为合成：当Kotlin编译代码时，会自动生成一些辅助类/方法（比如inline函数的适配实现、委托属性的底层逻辑方法、数据类的组件方法辅助等），文件级注解会让这些自动生成的元素带上synthetic标记，阻止Java代码编译期访问到这些内部实现细节。
• 避免干扰手动标记的成员：如果文件内既有需要暴露给Java的成员，又有需要隐藏的成员，文件级注解不会覆盖你给单个成员添加的@JvmSynthetic或其他注解，仅管控编译器生成的额外代码。

关于你的需求：完全隐藏Kotlin专属文件给Java用户 #

如果要让整个文件的顶层扩展对Java不可见，你需要给每个顶层成员单独添加@JvmSynthetic，文件级注解无法批量实现这个效果。另外，即使所有成员都设为合成，生成的顶层容器类（如ExtensionsKt）仍会存在，但Java用户无法访问其中的任何方法。

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