⚡ 状态持久化核心 —— rememberSaveable 在 Activity 重建与进程终止时自动保存/恢复，是 Compose 状态管理的“安”。

📌 1. 为什么需要 rememberSaveable？

🧪 2. 基本使用

语法与 remember 类似，但值会被序列化到 SavedStateHandle。

// 基础用法：自动保存/恢复
var count by rememberSaveable { mutableStateOf(0) }

// 自定义 Saver (例如保存非 Bundle 支持的类型)
var user by rememberSaveable(saver = UserSaver()) {
    mutableStateOf(User("小智", 12))
}

📊 对比 · remember / rememberSaveable

特性	remember	rememberSaveable
🎯 生命周期	Composition 存活期间	Composition + Activity 重建 / 进程恢复
📦 序列化	不需要	需要 (Bundle / Saver)
⚡ 屏幕旋转	❌ 丢失	✅ 自动恢复
🧩 自定义类型	直接存储	需实现 Saver 或 Parcelable/Serializable

⚠️ 3. 使用限制 & 注意事项

• Bundle 大小限制 —— 通常 < 1MB，过大可能导致 TransactionTooLargeException。
• 不支持所有类型 —— 默认只支持 Bundle 基本类型、String、Int、Boolean 等。自定义数据需要 Saver 或实现 Parcelable。
• 进程重建时机不确定 —— 仅当系统“杀死并重建”时恢复，用户主动“清除后台”可能不触发。
• 避免存储大量数据 —— 图片、Bitmap 等不适合，应使用 ViewModel + 持久化存储。
• List/Map 需谨慎 —— 默认支持 ArrayList / HashMap，但内部元素也需可序列化。

🧭 4. 保存与恢复流程 (SVG 架构)

🔧 5. 自定义 Saver (处理复杂对象)

当类型不是 Bundle 原生支持时，实现 Saver 或使用 mapSaver / listSaver。

// 示例：保存一个数据类 User
data class User(val name: String, val age: Int)

val UserSaver = Saver<User, String>(
    save = { user -> "${user.name}:${user.age}" },
    restore = { str ->
        val parts = str.split(":")
        User(parts[0], parts[1].toInt())
    }
)

// 使用
var user by rememberSaveable(saver = UserSaver) {
    mutableStateOf(User("小明", 10))
}

📌 典型场景 & 推荐方案

场景	推荐方案	说明
表单输入 (文本/开关)	rememberSaveable	屏幕旋转后保留用户输入
列表选中状态	rememberSaveable + Saver	保存选中 index 或 id 列表
网络请求结果	ViewModel + StateFlow	避免 Bundle 过大，且进程重建时重新加载
动画进度/播放状态	rememberSaveable	简单浮点/布尔值直接保存
大对象 / Bitmap	ViewModel + 磁盘/DataStore	Bundle 不适合，进程重建需持久化

⏳ 6. 生命周期对比 (remember vs rememberSaveable)