RecyclerView 进阶：DiffUtil 与列表更新

背景

在使用 RecyclerView 展示列表时我们经常需要动态更新数据。直接调用 notifyDataSetChanged 虽然简单粗暴。但会导致整个列表重绘，出现卡顿、闪烁，且没有动画效果。使用者最常抱怨的痛点：

• 列表滚动时突然卡顿，体验极差。
• 数据变化后界面没有任何过渡动画，看起来很突兀。
• 大数据量刷新时 UI 完全卡死。

DiffUtil 正是为了解决这些痛点而生。它能够智能计算新旧列表之间的差异，只刷新真正变化的项，从而提高性能并提供默认动画。

主要概念

什么是 DiffUtil？

DiffUtil 是 Android Support Library提供的工具类。用于比较两个列表，找出新增、删除、移动或修改的项，接下来通知 Adapter 做局部刷新。

工作原理

DiffUtil 基于 Eugene W. Myers 的差分算法。时间复杂度约为 O，其中 N 为列表长度，D 为变化次数。对大多数业务场景而言，这比一次性全量刷新要快数十倍。

代码实战

1️⃣ 创建数据模型

data class User(
val id: Long,// 唯一标识，用于判断是否是同一条数据
val name: String,val age: Int
) {
// 用于判断内容是否发生变化
fun isSameContent: Boolean {
return this.name == or.name && this.age == or.age
}
}

2️⃣ 实现 DiffUtil.Callback

class UserDiffCallback(
private val oldList: List。
private val newList: List
) : DiffUtil.Callback {
override fun getOldListSize: Int = oldList.size
override fun getNewListSize: Int = newList.size
// 判断是否是同一条数据
override fun areItemsTheSame: Boolean {
return oldList.id == newList.id
}
// 判断内容是否相同
override fun areContentsTheSame: Boolean {
return oldList.isSameContent
}
// 可选：返回变化的 payload，用于细粒度局部刷新
override fun getChangePayload: Any?{
val oldItem = oldList
val newItem = newList
val changes = mutableListOf
if changes.add
if changes.add
return if ) null else changes
}
}

3️⃣ 在 Adapter 中使用 DiffUtil

class UserAdapter : RecyclerView.Adapter {
private var userList: List = emptyList
/** 提交新列表并自动计算差异 */
fun submitList {
val diffResult = DiffUtil.calculateDiff)
userList = newList // 必须先更新内部引用
diffResult.dispatchUpdatesTo // 自动调用对应的 notify 方法
}
override fun onCreateViewHolder: UserViewHolder {
val view = LayoutInflater.from
.inflate
return UserViewHolder
}
override fun getItemCount: Int = userList.size
/** 普通绑定 */
override fun onBindViewHolder {
holder.bind
}
/** 支持 payload 的局部刷新 */
override fun onBindViewHolder(
从holder来看，UserViewHolder,position: Int。payloads: MutableList
) {
if ) {
onBindViewHolder
} else {
@Suppress
val changes = payloads as List
holder.bindPartial
}
}
inner class UserViewHolder : RecyclerView.ViewHolder {
private val nameText: TextView = itemView.findViewById
private val ageText : TextView = itemView.findViewById
fun bind {
nameText.text = user.name
ageText.text = "${user.age}岁"
}
/** 只更新变更字段，避免不必要的重绘 */
fun bindPartial {
if nameText.text = user.name
if ageText.text = "${user.age}岁"
}
}
}

4️⃣ 在 Activity / Fragment 中调用 Adapter

class MainActivity : AppCompatActivity {
private lateinit var adapter : UserAdapter
private var currentUsers : List = emptyList
override fun onCreate {
super.onCreate
setContentView
recyclerView.layoutManager = LinearLayoutManager
adapter = UserAdapter
recyclerView.adapter = adapter
// 模拟首次加载
currentUsers = generateDummyData
adapter.submitList
// 点击按钮模拟局部更新
btnUpdate.setOnClickListener {
val updated = currentUsers.map {
if it.copy else it
}
adapter.submitList // DiffUtil 自动计算差异并刷新
currentUsers = updated // 别忘了同步本地引用！}
}
private fun generateDummyData: List =
List { i -> User,name="User $i",age=20 + i%30) }
}

避坑教程

❌ 坑一：忘记实现 areItemsTheSame

错误示例：

// ❌ 用 position 判断，会导致移动、删除时误判为不同条目
override fun areItemsTheSame= oldPos==newPos

正确做法：

// ✅ 使用业务唯一 ID 判定同一条记录
override fun areItemsTheSame=
oldList.id == newList.id

❌ 坑二：areContentsTheSame 比较不完整

If you only compare part of fields UI will not refresh when or fields change . Ensure every UI‑displayed attribute participates in comparison.

❌ 坑三：在主线程直接调用 DiffUtil.calculateDiff

The method runs synchronously. With thousands of items it may block UI rendering.

// 推荐写法：在子线程完成计算。再回到主线程分发更新
lifecycleScope.launch {
val diffResult = DiffUtil.calculateDiff)
withContext{
diffResult.dispatchUpdatesTo
}
}

❌ 坑四：提交新列表后忘记更新 Adapter 内部的数据引用

If you call .dispatchUpdatesTo without assigning new list to your internal variable,subsequent diffs will still compare against stale list and produce wrong results.

⚡ 小技巧：

• 使用 Kotlin 的 .copy 来生成新对象，保持旧列表不可变。
• If your item layout is complex,consider using ViewBinding / DataBinding inside ViewHolder for cleaner code.
• You can combine DiffUtil with Paging 3 library for even larger datasets.

• areItemsTheSame： 用唯一 ID 判断“是不是同一条”。按理说，这是防止错误刷新的根本。说起来，
• areContentsTheSame： 全面比较所有 UI 展示字段。决定是否需要执行动画，
• getChangePayload： 返回细粒度变更集合，实现局部刷新、降低绘制成本。老实说，
• #性能调整： 大批量数据请放在子线程计算 Diff。主线程仅负责 UI 更新。
• #防止踩坑： 提交新列表后一定要同步内部引用；不要在回调里做耗时操作，

掌握了 DiffUtil，你就可以让 RecyclerView 在海量数据下依旧保持流畅、自然的动画效果。解决主要问题“刷新卡顿”“动画缺失”等使用者痛点，让你的 Android 应用体验上一个台阶！🚀