如何让RecyclerView中选中项置顶（含搜索功能场景）

嘿，这个需求我之前帮朋友实现过，核心思路就是对数据源做「分层过滤+排序」：先把选中的项单独拎出来，再处理搜索结果，最后把两者按「选中项在前」的规则合并。下面给你一步步拆解具体实现：

1. 先定义好你的数据模型 #

每个列表项得包含「唯一标识、文本内容、选中状态」三个核心字段，这样方便后续跟踪选中状态和排序：

data class ListItem(
    val id: String, // 用id做唯一标识，避免重复操作出错
    val text: String,
    var isChecked: Boolean = false
)

（如果是Java的话，改成对应的Bean类就行，逻辑完全一致）

2. 维护三个关键数据集合 #

你需要同时管理这三个集合，避免状态混乱：

• originalList: MutableList<ListItem>：存储所有原始的列表数据
• filteredList: MutableList<ListItem>：存储最终要显示在RecyclerView里的过滤后数据
• selectedItems: MutableSet<String>：存储所有选中项的id（用Set是为了自动去重，避免重复添加）
• currentSearchQuery: String：记录当前的搜索关键词，方便后续刷新时复用

3. 处理搜索逻辑：先过滤再排序 #

当用户输入搜索词时，先从原始列表里筛选出匹配的项，然后把其中的选中项移到最前面，最后合并成新的显示列表：

fun performSearch(query: String) {
    currentSearchQuery = query
    filteredList.clear()
    
    // 第一步：筛选出符合搜索条件的所有项
    val matchedItems = originalList.filter { 
        it.text.contains(query, ignoreCase = true) 
    }
    
    // 第二步：拆分选中和未选中的匹配项
    val selectedMatched = matchedItems.filter { selectedItems.contains(it.id) }
    val unselectedMatched = matchedItems.filterNot { selectedItems.contains(it.id) }
    
    // 第三步：合并，选中项在前，未选中项在后
    filteredList.addAll(selectedMatched + unselectedMatched)
    
    // 刷新列表（建议用DiffUtil提升性能，后面会说）
    adapter.notifyDataSetChanged()
}

4. 处理Checkbox的选中/取消操作 #

当用户点击Checkbox时，更新对应项的状态，同时维护选中集合，然后重新执行一次搜索逻辑（这样就能自动把选中项移到顶部了）：

fun onItemChecked(item: ListItem, isChecked: Boolean) {
    item.isChecked = isChecked
    if (isChecked) {
        selectedItems.add(item.id)
    } else {
        selectedItems.remove(item.id)
    }
    // 用当前的搜索关键词重新过滤排序，保证选中项置顶
    performSearch(currentSearchQuery)
}

5. 性能优化：用DiffUtil代替notifyDataSetChanged #

如果你的列表数据量比较大，直接用notifyDataSetChanged()会导致整个列表刷新，体验不好。建议用DiffUtil来计算列表差异，只更新变化的项：

class ItemDiffCallback(
    private val oldList: List<ListItem>,
    private val newList: List<ListItem>
) : DiffUtil.Callback() {
    override fun getOldListSize() = oldList.size
    override fun getNewListSize() = newList.size
    
    override fun areItemsTheSame(oldPos: Int, newPos: Int): Boolean {
        // 用id判断是不是同一个项
        return oldList[oldPos].id == newList[newPos].id
    }
    
    override fun areContentsTheSame(oldPos: Int, newPos: Int): Boolean {
        // 判断内容（文本、选中状态）是否一致
        return oldList[oldPos] == newList[newPos]
    }
}

// 修改performSearch里的刷新逻辑：
val newFilteredList = selectedMatched + unselectedMatched
val diffResult = DiffUtil.calculateDiff(ItemDiffCallback(filteredList, newFilteredList))
filteredList.clear()
filteredList.addAll(newFilteredList)
diffResult.dispatchUpdatesTo(adapter)

6. 特殊场景：选中项始终置顶（不受搜索关键词影响） #

如果你希望选中的项不管是否匹配搜索词，都一直显示在列表顶部，那可以调整搜索逻辑：先把所有选中项加进去，再加上匹配搜索的未选中项：

fun performSearch(query: String) {
    currentSearchQuery = query
    filteredList.clear()
    
    // 先加所有选中项（不管是否匹配搜索）
    val selectedAll = originalList.filter { selectedItems.contains(it.id) }
    // 再加匹配搜索的未选中项
    val unselectedMatched = originalList.filter { 
        !selectedItems.contains(it.id) && it.text.contains(query, ignoreCase = true) 
    }
    
    filteredList.addAll(selectedAll + unselectedMatched)
    // 用DiffUtil刷新列表
}

这样处理下来，不管是搜索操作还是选中操作，都能完美实现你要的「选中项置顶」效果啦～

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