第2章 MutableStateFlow 创建与基本使用：构造函数、初始值、value属性、emit方法

MutableStateFlow 是 Kotlin 协程中提供可变状态容器的基础组件，它同时暴露 读（通过 value 属性）和 写（通过 value 设值或 emit() 挂起函数）的能力。理解其创建与基本 API 是后续对比 SharedFlow 的基石。

核心原理

• 热流：始终保持最新值，新订阅的收集者立即收到当前值（而不像 Flow 冷流需要触发生产）。
• 状态容器：内部维护一个 value 属性，任何修改都会立即更新并通知所有活跃收集者。
• 防抖（conflation）：默认合并新值与旧值，若新值和旧值相等（通过 equals 比较）则跳过通知，避免无效重发。
• 线程安全：所有读写操作（包括 emit 和 value）都是线程安全的，不需要额外同步。

构造函数与初始值

创建示例：

// 基本创建
val counter = MutableStateFlow(0)           // 初始值为 Int 类型 0
val name = MutableStateFlow("Kotlin")       // 初始值为字符串
val list = MutableStateFlow(emptyList<Int>()) // 初始值为空列表

value 属性：同步读写

value 是一个可读可写的属性，读取立即返回当前最新值，写入直接更新状态并通知收集者。

// 读取
val current = counter.value   // 0

// 写入
counter.value = 10
counter.value = 20

// 线程安全：可以在任意线程调用
thread {
    counter.value = 99
}

emit() 方法：挂起写入

emit() 是 StateFlow 接口定义的方法，需要挂起协程。其行为与 value 赋值完全一致（都调用内部 setValue），但必须运行在协程中。

// 只能在协程内调用
viewModelScope.launch {
    counter.emit(30)
}

// 等价于
viewModelScope.launch {
    counter.value = 30
}

为什么需要 emit()？ 为了保持 Flow 接口通用性，emit() 是 FlowCollector 的标准发射方法，当把 MutableStateFlow 当作 FlowCollector 传递时，必须使用 emit()。

常见错误与调试

• 初始值 null 问题：如果状态可能为空，应显式使用 MutableStateFlow<Type?>(null)，否则类型推断会出问题。
• 忽略重复值过滤：StateFlow 默认使用 equals() 判断值是否变化。对于自定义类，务必正确实现 equals() 和 hashCode()，否则即使内容一致也会重复触发收集。
• 在非协程中调用 emit：IDE 会有编译错误（emit 是挂起函数），必须用 value 赋值代替。
• 并发写入竞态：虽然 value 和 emit 是线程安全的，但多个协程同时写入可能导致最终值与预期不符。推荐使用 update { } 原子更新（参见后续章节）。

// 错误示例：在 onClick 中用 emit
button.setOnClickListener {
    // 编译错误：Suspend function 'emit' should be called only from a coroutine
    counter.emit(1) 
}

// 正确：使用 value
button.setOnClickListener {
    counter.value = 1
}

性能与稳定性优化

调试提示：可以在 collect 中打印日志检查发射频率：

lifecycleScope.launch {
    counter.collect { value ->
        Log.d("StateFlow", "新值: $value")
    }
}