协程学习记录之提问Kimi：介绍一下Flow的用法

Kotlin Flow 是 Kotlin 协程生态中专门处理异步、连续数据流 的 API，官方推荐的响应式编程利器。下面按照"创建 → 加工 → 收集 → 线程切换 → 生命周期管理"的顺序，一次性讲透 Flow 的核心用法与最佳实践。

1. 创建 Flow（生产者）

方式	场景示例
`flow { ... }` 通用构造器	手动 `emit` 发射任意值，可调用挂起函数
`flowOf(...)`	快速把固定元素转成 Flow
`.asFlow()`	把集合、序列、Range 直接变 Flow

kotlin 复制代码

val tickerFlow = flow {
    while (true) {
        emit(api.fetchNews())   // 网络请求
        delay(5000)             // 每 5 秒拉一次
    }
}

2. 加工 Flow（中间操作符）

所有中间操作都是 冷流、惰性执行，直到被末端操作符触发。

常用链式操作：

kotlin 复制代码

flow
    .filter { it.isNotEmpty() }   // 过滤
    .map { it.toUiModel() }       // 转换
    .distinctUntilChanged()       // 去重
    .onEach { cache(it) }         // 副作用

3. 收集 Flow（末端操作符）

操作符	作用
`collect`	最通用，挂起函数，需协程作用域
`collectLatest`	新值到达时取消旧收集，适合搜索框防抖
`toList()` / `first()` / `single()`	终端快捷函数

kotlin 复制代码

lifecycleScope.launchWhenStarted {
    vm.newsFlow.collect { list ->
        adapter.submitList(list)
    }
}

4. 线程切换

使用 flowOn 仅改变上游执行线程，下游仍在原作用域线程。

kotlin 复制代码

flow
    .map { heavyCpu(it) }          // 默认线程
    .flowOn(Dispatchers.Default)   // 改到 Default
    .collect { updateUI(it) }      // 回到主线程

5. Android 生命周期级 Flow

作用域	说明
`viewModelScope`	ViewModel 销毁时自动取消
`lifecycleScope`	Activity/Fragment 生命周期作用域
`repeatOnLifecycle`	生命周期安全收集（官方推荐）

kotlin 复制代码

// 在 Fragment 中
viewLifecycleOwner.lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        vm.uiState.collect { render(it) }
    }
}

6. StateFlow & SharedFlow（UI 状态专用）

类型	特点	典型用法
`StateFlow<T>`	有初始值、粘性、只保留最新值	UI 单向状态
`SharedFlow<T>`	无初始值、可配置重播、支持多订阅	事件总线

ViewModel → UI 的最简模板：

kotlin 复制代码

class VM : ViewModel() {
    private val _state = MutableStateFlow(Loading)
    val state = _state.asStateFlow()

    fun load() = viewModelScope.launch {
        _state.value = repo.load()
    }
}

在 Compose 中：

kotlin 复制代码

val state by vm.state.collectAsStateWithLifecycle()

7. 取消与背压

协程作用域取消 → Flow 自动结束。
使用 cancellable() 操作符显式支持取消检查。
buffer() / conflate() / collectLatest() 处理背压。

8. 完整示例：网络 → 缓存 → UI

kotlin 复制代码

class NewsRepo(
    private val api: NewsApi
) {
    fun news(): Flow<List<Article>> = flow {
        while (true) {
            emit(api.fetch())          // 网络
            delay(30_000)              // 30 秒轮询
        }
    }
    .flowOn(Dispatchers.IO)            // 网络线程
    .onEach { cache.save(it) }         // 缓存
    .catch { emit(cache.get()) }       // 失败兜底
}

9. 一站式学习资源

官方文档中文版 （含 Codelab）：
developer.android.com/kotlin/flow...
掘金系列教程 （含源码）：
juejin.cn/post/733675...
Kotlin 官方文档 （深度原理）：
book.kotlincn.net/text/flow.h...

一句话总结：
Flow = 协程 + 响应式，把"一次性"的 suspend 函数升级为"持续不断"的异步数据流，Android 官方推荐的现代异步方案。