如何在Jetpack Compose中定义多可选字符串变体类型？解决报错

错误原因 #

你写的variant: String = "dark" | "light"不是Kotlin支持的语法，编译器无法识别这种写法，因此抛出Expecting a top level declaration错误。要实现参数仅允许传入特定值的需求，**枚举（Enum）**是Kotlin里的标准解决方案，能在编译阶段就限制传入的参数类型，避免非法值。

实现步骤与代码 #

1. 定义枚举类
   创建一个枚举类来限定允许的variant值，替代原来的String类型：

enum class LabelVariant {
    Dark, Light
}

2. 修改Label组合函数
   将variant参数的类型改为上面定义的枚举类，默认值设为LabelVariant.Dark，然后根据枚举值切换Text颜色：

@Composable
fun Label(
    label: String,
    variant: LabelVariant = LabelVariant.Dark
) {
    Text(
        text = label,
        fontSize = 24.sp,
        color = when(variant) {
            LabelVariant.Dark -> Color.Black
            LabelVariant.Light -> Color.Yellow
        }
    )
}

3. 调用示例
   调用时只能传入枚举类的实例，编译器会自动提示合法选项，避免传错：

// 使用默认的Dark变体
Label(label = "默认深色标签")

// 指定Light变体
Label(label = "浅色标签", variant = LabelVariant.Light)

为什么用枚举？ #

• 编译时校验：如果传入非枚举的其他值，编译器直接报错，避免运行时因字符串拼写错误导致的bug。
• 代码可读性：枚举值语义明确，比裸字符串更易维护。
• 扩展性：后续如果需要新增变体（比如"primary"），直接在枚举类里加新值即可，不用修改多处判断逻辑。

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