RecyclerView上下文操作模式异常：长按仅单行列显示复选框

我帮你梳理下这个问题的常见原因和修复方案，你可以对照自己的代码一步步排查：

核心问题分析 #

你遇到的情况是操作模式下只有长按触发的条目显示复选框，本质上大概率是选中状态管理不当或者没有通知所有条目刷新状态导致的。下面分点拆解：

1. 检查选中状态的存储方式 #

很多开发者会犯的错是用单个变量（比如selectedPosition）记录选中位置，这种方式只能跟踪一个条目。操作模式下需要用集合类来管理所有选中的条目，比如SparseBooleanArray（适合位置索引）或者HashSet<Integer>。

示例代码（适配器内）：

// 全局标记是否处于操作模式
private boolean isActionModeActive = false;
// 存储所有选中的条目位置
private SparseBooleanArray selectedPositions = new SparseBooleanArray();

2. 启动操作模式时必须刷新所有条目 #

长按触发操作模式后，你不仅要把当前条目加入选中集合，还要调用notifyDataSetChanged()让RecyclerView的所有条目重新绑定。如果只更新长按的那个条目，其他条目不会重新执行绑定逻辑，自然还是保持非操作模式下的隐藏状态。

示例启动操作模式的方法：

public void startActionMode(int position) {
    isActionModeActive = true;
    selectedPositions.put(position, true);
    notifyDataSetChanged(); // 关键！通知所有条目刷新状态
}

3. 修正ViewHolder的绑定逻辑 #

在onBindViewHolder里，必须同时判断两个条件：是否处于操作模式、当前条目是否被选中，才能正确控制复选框的显示/隐藏和选中状态。

示例绑定逻辑：

@Override
public void onBindViewHolder(ViewHolder holder, int position) {
    // 先处理正常的内容绑定（比如标题、图片等）
    holder.tvItemTitle.setText(mDataList.get(position).getTitle());

    // 处理复选框的显示逻辑
    if (isActionModeActive) {
        holder.cbItemCheck.setVisibility(View.VISIBLE);
        // 根据集合判断当前条目是否被选中
        holder.cbItemCheck.setChecked(selectedPositions.get(position, false));
    } else {
        holder.cbItemCheck.setVisibility(View.GONE);
    }

    // 长按事件：启动操作模式或切换选中状态
    holder.itemView.setOnLongClickListener(v -> {
        if (!isActionModeActive) {
            // 通过接口回调通知Activity/Fragment启动上下文操作栏
            mActionModeListener.onStartActionMode(position);
        } else {
            toggleItemSelection(position);
        }
        return true;
    });

    // 点击事件：操作模式下切换选中状态
    holder.itemView.setOnClickListener(v -> {
        if (isActionModeActive) {
            toggleItemSelection(position);
        } else {
            // 非操作模式下的正常点击逻辑
        }
    });
}

// 辅助方法：切换条目选中状态
private void toggleItemSelection(int position) {
    if (selectedPositions.get(position, false)) {
        selectedPositions.delete(position);
    } else {
        selectedPositions.put(position, true);
    }
    notifyItemChanged(position);
}

4. 处理ViewHolder复用问题 #

RecyclerView的ViewHolder会被复用，所以一定要在onBindViewHolder里每次都明确设置复选框的状态，不要依赖控件的默认状态。比如不能只在选中时设置勾选，未选中时也要主动设置未勾选，避免复用旧的状态。

5. 条目XML的初始状态 #

确保你的条目布局里，复选框的默认visibility是gone，这样非操作模式下默认隐藏，操作模式下再切换为visible：

<CheckBox
    android:id="@+id/cb_item_check"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:visibility="gone" />

最后补充：操作模式的收尾 #

当关闭上下文操作栏时，要重置操作模式标记和选中集合，同时再次刷新所有条目：

public void finishActionMode() {
    isActionModeActive = false;
    selectedPositions.clear();
    notifyDataSetChanged();
}

你可以对照这些点检查自己的代码，大概率是其中某一步没处理到位导致的问题。

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