Kotlin 与 Jetpack Compose 参数设计完全指南

作为 Kotlin 和 Jetpack Compose 开发者，合理的参数设计能显著提升代码的可读性和易用性。本文将系统整理各类参数规则，帮助您编写更优雅的 API。

一、基础参数规则

1. 方法参数

// 基础定义
fun 方法名(必需参数: 类型, 可选参数: 类型 = 默认值): 返回类型 {
    // 方法体
}

// 实际示例
fun fetchData(
    url: String,              // 必需参数
    timeout: Int = 5000,      // 可选参数
    callback: (Result) -> Unit // 函数参数
) { /*...*/ }

调用方式：

// 必需参数必须传递
fetchData("https://example.com")  // 缺少 callback 编译错误

// 命名参数调用（推荐）
fetchData(
    url = "https://example.com",
    callback = { result -> /*...*/ }
)

// 跳过可选参数
fetchData("https://example.com", callback = { /*...*/ })

2. 类构造函数参数

class User(
    val id: String,          // 只读属性
    var name: String,        // 可变属性
    age: Int = 18,           // 私有属性（无val/var）
    val status: String = "active"
) {
    // age只能在类内部访问
}

二、高级参数特性

1. 可变参数 (vararg)

fun printAll(vararg messages: String) {
    messages.forEach { println(it) }
}

// 调用
printAll("Hello")            // 单参数
printAll("A", "B", "C")      // 多参数
printAll(*arrayOf("D", "E")) // 数组展开

2. 解构声明参数

data class Point(val x: Int, val y: Int)

fun draw((x, y): Point) {  // 参数解构
    println("Drawing at ($x, $y)")
}

三、Compose 组件参数规范

1. 基础组件模板

@Composable
fun MyComponent(
    // 1. 修饰符（必须首位）
    modifier: Modifier = Modifier,
    
    // 2. 必需状态参数
    value: Int,
    
    // 3. 可选状态参数
    secondaryValue: Int = 0,
    
    // 4. 回调函数
    onValueChange: (Int) -> Unit,
    
    // 5. 内容槽
    content: @Composable () -> Unit = {}
) {
    Box(modifier) {
        // 组件实现
    }
}

2. 参数设计最佳实践

3. 状态参数示例

@Composable
fun Counter(
    count: Int,                   // 只读状态
    onIncrement: () -> Unit,       // 递增回调
    modifier: Modifier = Modifier, // 修饰符
    maxCount: Int = Int.MAX_VALUE  // 可选配置
) {
    Button(
        onClick = { if (count < maxCount) onIncrement() },
        modifier = modifier,
        enabled = count < maxCount
    ) {
        Text("Count: $count")
    }
}

四、可省略参数场景

1. 所有带默认值的参数

// 定义
fun search(
    query: String,
    caseSensitive: Boolean = false,
    limit: Int = 10
) { /*...*/ }

// 调用
search("kotlin")  // 只传必需参数

2. Compose 特有省略

// 定义
@Composable
fun IconLabel(
    icon: @Composable () -> Unit,
    label: String = "",      // 可选文本
    modifier: Modifier = Modifier
) { /*...*/ }

// 调用
IconLabel(icon = { Icon(Icons.Filled.Home) })  // 省略 label 和 modifier

3. 尾随 Lambda 省略

// 定义
fun runAfterDelay(
    delay: Long,
    block: () -> Unit = {}
) { /*...*/ }

// 调用
runAfterDelay(1000)  // 省略 block 参数

五、参数设计原则

1. 必要参数优先：关键参数放在前面
2. 合理默认值：为常用选项提供默认值
3. 命名一致性：保持与标准库一致的命名
4. 参数分组：相关参数相邻放置
5. 避免过多参数：超过5个考虑使用配置类

// 不良设计
fun badDesign(
    param1: Int,
    param2: String,
    param3: Boolean,
    param4: Float,
    param5: Long,
    param6: Double
) { /*...*/ }

// 优化设计
data class Config(
    val setting1: Int,
    val setting2: String,
    val setting3: Boolean = false,
    /*...*/
)

fun goodDesign(config: Config) { /*...*/ }

通过遵循这些参数设计规范，您的 Kotlin 和 Compose 代码将更加清晰、易用且易于维护。记住，好的API设计应该让常见的使用场景简单，同时支持复杂场景的可能。