RecyclerView多条目时拖拽排序异常问题求助

核心问题定位 #

从代码和描述来看，拖拽在条目增多后异常困难，主要由以下几个关键问题导致：

1. onMove方法返回false：ItemTouchHelper要求onMove返回true来确认已处理移动操作，返回false会让系统放弃后续的拖拽位置同步，导致条目无法跟随手势正常移动，条目越多这个问题越明显。
2. 数据更新方式错误：使用Collections.swap每次仅交换相邻条目，当拖拽跨多个条目时，数据与UI的位置会逐步错位，导致拖拽手势与实际条目移动不匹配。
3. 重复初始化ItemTouchHelper与ItemDecoration：每次重新创建并绑定ItemTouchHelper、反复移除添加分割线，会导致RecyclerView状态混乱，影响拖拽的流畅性。
4. 拖拽位置标记未重置：clearView中未重置mPositionDraggedFrom和mPositionDraggedTo，会导致下次拖拽时携带旧状态，引发错误的数据更新。

具体修复步骤 #

1. 修正onMove方法的返回值与数据更新逻辑

替换原onMove中的代码，改为正确的条目移动逻辑并返回true：

override fun onMove(
    recyclerView: RecyclerView,
    dragged: RecyclerView.ViewHolder,
    target: RecyclerView.ViewHolder
): Boolean {
    val draggedPosition = dragged.adapterPosition
    val targetPosition = target.adapterPosition

    // 记录初始拖拽位置
    if (mPositionDraggedFrom == -1) {
        mPositionDraggedFrom = draggedPosition
    }
    mPositionDraggedTo = targetPosition

    // 正确移动数据：移除拖拽条目，添加到目标位置
    val draggedTask = mPlanDetails.dayPlanList[mDayPlanPosition].tasks.removeAt(draggedPosition)
    mPlanDetails.dayPlanList[mDayPlanPosition].tasks.add(targetPosition, draggedTask)
    
    // 通知Adapter更新UI
    taskAdapter.notifyItemMoved(draggedPosition, targetPosition)
    
    // 返回true告诉系统已处理移动
    return true
}

2. 重置拖拽位置标记

在clearView方法末尾添加重置逻辑，避免旧状态干扰下次拖拽：

override fun clearView(
    recyclerView: RecyclerView,
    viewHolder: RecyclerView.ViewHolder
) {
    super.clearView(recyclerView, viewHolder)

    if (mPositionDraggedFrom != -1 && mPositionDraggedTo != -1 &&
        mPositionDraggedFrom != mPositionDraggedTo
    ) {
        updateTasksInDayPlan(
            mDayPlanPosition, mPlanDetails.dayPlanList[mDayPlanPosition].tasks
        )
    }
    
    // 重置拖拽位置标记
    mPositionDraggedFrom = -1
    mPositionDraggedTo = -1
}

3. 避免重复初始化ItemTouchHelper与ItemDecoration

将ItemTouchHelper的初始化移至onCreate或页面初始化阶段，仅创建一次；分割线DividerItemDecoration也只添加一次，不要反复移除再添加：

// 在页面初始化时（比如onCreate）执行一次
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.your_layout)

    // 初始化分割线
    val dividerItemDecoration = DividerItemDecoration(this, DividerItemDecoration.VERTICAL)
    rvTaskList?.addItemDecoration(dividerItemDecoration)

    // 初始化ItemTouchHelper
    itemTouchHelper = ItemTouchHelper(object : SwipeHelper(rvTaskList) {
        // 实现你的回调方法...
    })
    itemTouchHelper?.attachToRecyclerView(rvTaskList)
}

4. 优化RecyclerView性能（条目多时尤为重要）

• 确保Item布局层级尽量简单，减少嵌套，避免过度绘制；
• 若条目中有可点击控件（如Button、TextView），设置android:focusable="false"和android:focusableInTouchMode="false"，避免触摸事件冲突；
• 确认RecyclerView使用的是LinearLayoutManager（拖拽排序仅支持线性布局管理器）。

额外建议 #

如果拖拽时仍有卡顿，可以尝试开启RecyclerView的硬件加速，或者在SwipeHelper中调整拖拽的灵敏度，比如重写getDragDirs方法，确保拖拽触发区域合理。

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