如何基于SharedPreferences的Observable更新RecyclerView的ViewHolder？

核心设计原则：所有列表项的按钮状态必须以Observable持有的全局验证状态为唯一可信数据源，禁止在ViewHolder内部独立存储验证状态，从根源上避免列表滚动时的状态错位问题。

具体实现步骤 #

1. 统一在适配器层管理Observable订阅 #

不要在每个ViewHolder内部单独订阅Observable，否则会造成重复订阅、内存泄漏、列表滚动时多次触发更新的问题：

• 给适配器传入SharedPreferences对应的Observable实例，以及页面的LifecycleOwner，绑定订阅生命周期
• 初始化时完成订阅，收到新状态后先做去重判断，状态发生真实变化时再触发列表更新
  参考实现代码：

class VerifyListAdapter(
    private val verifyStateObservable: Observable<Boolean>,
    private val lifecycleOwner: LifecycleOwner
) : RecyclerView.Adapter<VerifyListViewHolder>() {
    // 作为列表渲染验证状态的唯一本地缓存
    private var currentVerifyState: Boolean = false
    // 定义局部更新的标识，避免全量刷新
    private val PAYLOAD_VERIFY_STATE_CHANGE = "payload_verify_state"

    init {
        verifyStateObservable
            // 过滤重复值，状态无变化时不触发更新
            .distinctUntilChanged()
            .subscribe { newState ->
                if (newState != currentVerifyState) {
                    currentVerifyState = newState
                    // 只触发所有item的局部更新，不做全量绑定
                    notifyItemRangeChanged(0, itemCount, PAYLOAD_VERIFY_STATE_CHANGE)
                }
            }
            // 页面销毁时自动取消订阅，避免内存泄漏
            .also { disposable ->
                lifecycleOwner.lifecycle.addObserver(LifecycleEventObserver { _, event ->
                    if (event == Lifecycle.Event.ON_DESTROY) disposable.dispose()
                })
            }
    }
}

2. 改造ViewHolder的绑定逻辑，支持局部更新 #

重写适配器带payload参数的onBindViewHolder方法，收到验证状态变更的通知时，只更新按钮文本，不触发整个item的全量重新绑定，避免不必要的性能损耗：

override fun onBindViewHolder(holder: VerifyListViewHolder, position: Int, payloads: MutableList<Any>) {
    // 处理验证状态变更的局部更新逻辑
    if (payloads.contains(PAYLOAD_VERIFY_STATE_CHANGE)) {
        holder.updateVerifyBtnText(currentVerifyState)
        return
    }
    // 正常的item全量绑定逻辑
    super.onBindViewHolder(holder, position, payloads)
    holder.bind(getItem(position), currentVerifyState)
}

ViewHolder内部提供两个独立的绑定方法，分别适配全量初始化和局部更新的场景：

class VerifyListViewHolder(view: View) : RecyclerView.ViewHolder(view) {
    private val verifyBtn: Button = view.findViewById(R.id.btn_verify)

    // 局部更新专用：只更新按钮文本
    fun updateVerifyBtnText(isVerified: Boolean) {
        verifyBtn.text = if (isVerified) "已完成验证" else "前往验证"
    }

    // 全量绑定专用：处理item内所有控件的初始化逻辑
    fun bind(itemInfo: ItemModel, isVerified: Boolean) {
        // 其他控件的绑定逻辑（如标题、封面等）
        updateVerifyBtnText(isVerified)
    }
}

常见踩坑提醒 #

• 不要在ViewHolder的按钮点击回调里直接修改按钮文本：用户点击触发验证后，只需要按流程更新SharedPreferences中存储的验证值，后续的按钮更新完全由Observable的订阅链路触发，避免手动改的状态被列表回收复用覆盖，造成滚动后状态错位
• 不要直接使用notifyDataSetChanged()触发全列表更新：这种方式会重置所有item的控件状态，比如输入框焦点、图片加载状态，还会造成不必要的性能浪费，通过payload做局部更新是更合理的选择
• 一定要加值去重逻辑：如果SharedPreferences的Observable是监听整个文件的所有键值变动，不加distinctUntilChanged的话，其他无关的配置变动都会触发全列表的按钮刷新
• 不需要手动遍历所有存在的ViewHolder修改按钮文本：RecyclerView的回收复用机制会保证，当所有item被通知更新时，当前可见的ViewHolder会立即触发绑定逻辑；被回收的不可见ViewHolder，在下次滑入屏幕时会自动读取适配器缓存的最新验证状态渲染按钮文本，逻辑是完全统一的

内容的提问来源于stack exchange，提问作者barasingha