Kotlin枚举导出JS后在Angular项目中编译报错求助

问题根源 #

Kotlin JS通过@JsExport导出枚举时，会自动给枚举的val属性生成带get前缀的访问器方法（比如把Kotlin里的val value转换成TS里的getValue(): string）。而Angular默认启用的严格TypeScript编译配置（比如strict: true）会对这类自动生成的声明做更严格的校验，比如要求方法返回类型完全匹配、或者不允许这类和常规属性访问模式不符的getter声明，从而触发编译错误。

编辑器没提示错误，大概率是因为编辑器使用的TS配置和Angular编译时的配置不一致——比如编辑器用根目录的tsconfig.json，而ng serve用的是tsconfig.app.json，后者开启了更严格的检查规则。

解决办法 #

1. 临时修改自动生成的d.ts文件 #

找到生成的module_name.d.ts，把带get前缀的方法声明改成普通属性：

原自动生成代码：

export enum InterEnum {
    FIRST,
    SECOND
}
export namespace InterEnum {
    export function FIRST(): InterEnum;
    export function SECOND(): InterEnum;
    export function getValue(): string;
}

修改后：

export enum InterEnum {
    FIRST,
    SECOND
}
export namespace InterEnum {
    export function FIRST(): InterEnum;
    export function SECOND(): InterEnum;
    export const value: string;
}

注意：每次重新编译Kotlin代码生成新的d.ts时，这个修改会被覆盖，仅适合临时测试用。

2. 在Kotlin代码里指定导出名称（推荐） #

通过@JsName注解强制指定枚举属性导出后的名称，去掉get前缀，让生成的TS声明符合常规属性格式：

@OptIn(ExperimentalJsExport::class)
@JsExport
enum class InterEnum(private val internalValue: String) {
    FIRST("first"),
    SECOND("second");

    @JsName("value")
    fun getValue(): String = internalValue
}

这样生成的TS声明里会直接出现value: string，而非getValue()，和TS的属性访问习惯一致，Angular编译就不会报错。

3. 放宽Angular的TS编译配置（不推荐） #

打开tsconfig.app.json，把strict设为false，或者单独关闭触发错误的选项（比如strictPropertyInitialization、noImplicitAny）。但这种做法会降低TypeScript的类型安全性，可能埋下其他代码隐患，仅建议紧急情况下临时使用。

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