Kotlin 协程与 Flow

适用于 Android 和 Kotlin 多平台项目的结构化并发模式、基于 Flow 的响应式流以及协程测试。

何时启用

• 使用 Kotlin 协程编写异步代码
• 使用 Flow、StateFlow 或 SharedFlow 实现响应式数据
• 处理并发操作（并行加载、防抖、重试）
• 测试协程和 Flow
• 管理协程作用域与取消

结构化并发

作用域层级

Application
  └── viewModelScope (ViewModel)
        └── coroutineScope { } (结构化子作用域)
              ├── async { } (并发任务)
              └── async { } (并发任务)

始终使用结构化并发——绝不使用 GlobalScope：

// BAD
GlobalScope.launch { fetchData() }

// GOOD — scoped to ViewModel lifecycle
viewModelScope.launch { fetchData() }

// GOOD — scoped to composable lifecycle
LaunchedEffect(key) { fetchData() }

并行分解

使用 coroutineScope + async 处理并行工作：

suspend fun loadDashboard(): Dashboard = coroutineScope {
    val items = async { itemRepository.getRecent() }
    val stats = async { statsRepository.getToday() }
    val profile = async { userRepository.getCurrent() }
    Dashboard(
        items = items.await(),
        stats = stats.await(),
        profile = profile.await()
    )
}

SupervisorScope

当子协程失败不应取消同级协程时，使用 supervisorScope：

suspend fun syncAll() = supervisorScope {
    launch { syncItems() }       // failure here won't can…