一、什么是副作用

玄学。

在 Compose 里Composable 最理想的状态是：给它什么状态，它就画什么 UI。

@Composable
fun Greeting {
Text
}

这段代码很纯粹：传入 name显示文字，没有偷偷做别的事。

真实开发常见痛点：

• 页面第一次进入时加载数据，却写在 Composable 里导致每次重组都重新请求。
• 输入框内容变化后延迟搜索。如果协程没有被正确取消，会出现旧请求覆盖新结果。
• 点击按钮弹 Snackbar，直接在 UI 线程里调用会卡顿。
• 页面离开时忘记取消监听，导致内存泄漏。
• 倒计时结束后回调失效，因为持有的是旧的 lambda 引用。

这些都不是“画 UI”本身。 而是在 UI 之外额外做的事情，所以叫副作用。

行为	是不是副作用	原因
显示一段文字	No	只是根据状态画 UI
在 Composable 函数体执行期间直接修改 MutableState	No	可能导致重复重组或不可预测行为
在点击、输入等事件回调里修改状态	No
启动协程请求数据
注册生命周期监听并忘记移除
弹 Snackbar	Yes	不是静态 UI

A 这些事情通常写在 Activity/Fragment 生命周期方法里：

override fun onStart {
super.onStart
startLocationUpdates
}
override fun onStop {
stopLocationUpdates
super.onStop
}

A 在 Compose 里没有直接对应的  方法。Compose 给了我们一套专门处理副作用、派生状态和重组控制的 API：

< / t d r h o p e l s u m i d n e v r e h t a f l e s a e r a r e v o C s u d o t n i w n u f k c u m i d t o N p m I < td derivedStateOf

API	适合场景	类型/关键点
LaunchedEffect	启动协程、状态变化后执行挂起任务	副作用
rememberCoroutineScope	在点击事件中手动启动协程	副作用辅助
DisposableEffect	注册监听。并在离开时清理副作用
rememberUpdatedState 在长时间运行的 Effect 中拿到最新回调/值	Effect 辅助
="" /table

The key takeaway:二、添加依赖

libs.versions.toml

app/build.gradle.kts
This configuration simply pulls in core Compose runtime,Material‑3 components and lifecycle integration – nothing more.

`LaunchedEffect` 是最常用的副作用 API。它适合做这些事：


页面第一次显示时执行一次任务 

某个 key 变化后重新执行任务 

在 Composable 生命周期内启动协程 

key 变化或离开组合时自动取消旧任务 
<\/ul>

A 简单例子——输入使用者名后延迟校验：
@Composable
private fun UsernameChecker {
var username by rememberSaveable { mutableStateOf }
var message by rememberSaveable { mutableStateOf }
LaunchedEffect {
if ) {
message = "请输入使用者名"
return@LaunchedEffect
}
delay // 模拟网络防抖
message =
if "使用者名可用"
else “使用者名至少需要6个字符”
}
Column) {
OutlinedTextField(
value = username。onValueChange={ username=it },label ={ Text })
Text
}
}

A 步骤说明：


`username` 是输入框的 State。

`LaunchedEffect` 表示只要 `username` 改变，就会 **重新启动** 协程并 **自动取消** 上一次未完成的协程。

If 使用者快速输入。旧协程被取消，新协程开始，实现防抖效果。
<\/ol>

// sequenceDiagram omitted for brevity
<\/div>

说到常见错误，不要把协程直接写在 Composable 函数体里

---