如何让Kotlin代码兼容JVM后端与JS前端并实现JS导出？

算力阿峰

2026-8-2

解决方案

方法一：为JVM项目提供空的`@JsExport`注解实现

由于JVM项目编译时无法识别Kotlin/JS标准库的kotlin.js.JsExport注解，你可以在JVM项目的源码中创建一个同名的空注解类，让编译器跳过错误：

在JVM项目的src/main/kotlin/kotlin/js路径下创建JsExport.kt文件
写入以下代码：

package kotlin.js

@Retention(AnnotationRetention.BINARY)
@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY)
annotation class JsExport

这样JVM编译时会识别这个本地注解，不会报错；而JS项目仍会使用标准库中的@JsExport，完全不影响导出功能。

方法二：使用`expect/actual`注解适配双平台

这种方式更符合Kotlin的平台适配规范，通过定义期望注解，再分别为JS和JVM提供实际实现：

在共用源码中定义expect注解：

@OptionalExpectation
@Retention(AnnotationRetention.BINARY)
@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY)
expect annotation class JsExport()

在JS项目中添加actual类型别名，映射到标准库注解：

actual typealias JsExport = kotlin.js.JsExport

在JVM项目中添加actual空注解：

@Retention(AnnotationRetention.BINARY)
@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY)
actual annotation class JsExport()

之后你在共用源码中直接使用@JsExport即可，JS项目会正常导出类/方法，JVM项目则会忽略注解的实际作用，保持兼容性。