单布局双RecyclerView问题：垂直列表Checkbox选中状态异常

你的问题主要源于两个核心问题：

• RecyclerView ViewHolder复用导致状态混乱：你直接操作ViewHolder里的Checkbox状态，但没有用数据源持久化选中状态，当列表滚动触发ViewHolder复用时，就会出现选中错位或无法选中的情况。
• 水平列表移除时的索引对应错误：你在水平列表的点击事件里用mUserKey.get(position)，但这里的position是水平选中列表的索引，和原垂直列表的mUserKey数组索引不匹配，导致找不到正确的用户去更新状态。

我们从数据源维护状态和修正索引对应关系两个方向来修复：

1. 用数据源持久化选中状态（核心） #

不要依赖Checkbox的UI状态记录选中情况，改用HashMap<String, Boolean>（key为用户唯一标识userKey，value为是否选中）来保存每个用户的选中状态，这样无论ViewHolder怎么复用，都能从数据源获取正确状态。

2. 修正垂直RecyclerView的点击与绑定逻辑 #

在onBindViewHolder中根据数据源状态设置Checkbox选中状态，点击item时更新数据源，再通知适配器刷新对应项（而非全局刷新）。

修改后的垂直Adapter核心代码：

// 新增成员变量：记录选中状态的HashMap与用户key列表
private HashMap<String, Boolean> mSelectedStatus;
private List<String> mUserKeyList;

// 构造方法传入必要参数
public PickMemberAdapter(Context context, List<String> userNameList, List<String> userDescList, List<String> userPicList, List<String> userKeyList, HashMap<String, Boolean> selectedStatus, RecyclerViewItemClick listener) {
    this.mUserNameList = userNameList;
    this.mUserDescList = userDescList;
    this.mUserPicList = userPicList;
    this.mUserKeyList = userKeyList;
    this.mSelectedStatus = selectedStatus;
    this.mListener = listener;
}

@Override
public void onBindViewHolder(@NonNull UsersViewHolders holder, int position) {
    String userKey = mUserKeyList.get(position);
    holder.setName(mUserNameList.get(position));
    holder.setDesc(mUserDescList.get(position));
    holder.setImage(mUserPicList.get(position));

    // 先清除旧的监听，避免复用触发错误逻辑
    holder.mCheckBox.setOnCheckedChangeListener(null);
    // 从数据源获取状态，设置Checkbox
    holder.mCheckBox.setChecked(mSelectedStatus.getOrDefault(userKey, false));

    holder.itemView.setOnClickListener(v -> {
        // 更新数据源的选中状态
        boolean newStatus = !mSelectedStatus.getOrDefault(userKey, false);
        mSelectedStatus.put(userKey, newStatus);
        // 只刷新当前项，提升性能
        notifyItemChanged(position);
        // 回调给Activity更新水平列表
        mListener.onItemCheckChanged(userKey, mUserNameList.get(position), newStatus);
    });
}

// 优化接口参数，传递更清晰的信息
public interface RecyclerViewItemClick {
    void onItemCheckChanged(String userKey, String userName, boolean isSelected);
}

3. 修正水平RecyclerView的移除逻辑 #

水平列表的数据源需同时保存userKey和userName，这样点击移除时能拿到对应用户的唯一标识，进而更新原列表的选中状态。

首先创建选中用户的实体类：

public class SelectedUser {
    public String userKey;
    public String userName;

    public SelectedUser(String userKey, String userName) {
        this.userKey = userKey;
        this.userName = userName;
    }
}

然后修改Activity与水平Adapter的逻辑：

Activity中初始化相关变量：

// 替换原有的mSelectedUser和mSelectedName
private List<SelectedUser> mSelectedUsers = new ArrayList<>();
private HashMap<String, Boolean> mSelectedStatus = new HashMap<>();

private void setUpAdapter() {
    mUsersAdapter = new PickMemberAdapter(this, mUserNameList, mUserDescList, mUserPicList, mUserKeyList, mSelectedStatus, new PickMemberAdapter.RecyclerViewItemClick() {
        @Override
        public void onItemCheckChanged(String userKey, String userName, boolean isSelected) {
            if (isSelected) {
                mSelectedUsers.add(new SelectedUser(userKey, userName));
            } else {
                // 从选中列表移除对应用户
                for (int i = 0; i < mSelectedUsers.size(); i++) {
                    if (mSelectedUsers.get(i).userKey.equals(userKey)) {
                        mSelectedUsers.remove(i);
                        break;
                    }
                }
            }
            mSelectedAdapter.notifyDataSetChanged();
        }
    });

    mSelectedAdapter = new SelectedUserAdapter(mSelectedUsers, new SelectedUserAdapter.RecyclerViewUnselect() {
        @Override
        public void onItemRemoveClick(SelectedUser selectedUser, int position) {
            // 更新原列表的选中状态
            mSelectedStatus.put(selectedUser.userKey, false);
            // 移除选中列表的项
            mSelectedUsers.remove(position);
            // 刷新垂直列表的对应项（而非全局刷新）
            int originalPosition = mUserKeyList.indexOf(selectedUser.userKey);
            if (originalPosition != -1) {
                mUsersAdapter.notifyItemChanged(originalPosition);
            }
            mSelectedAdapter.notifyItemChanged(position);
        }
    });

    mSearchList.setAdapter(mUsersAdapter);
    mSelectedUserList.setAdapter(mSelectedAdapter);
}

水平Adapter核心代码：

public class SelectedUserAdapter extends RecyclerView.Adapter<SelectedUserAdapter.SelectedViewHolder> {
    private List<SelectedUser> mSelectedUsers;
    private RecyclerViewUnselect mListener;

    public interface RecyclerViewUnselect {
        void onItemRemoveClick(SelectedUser selectedUser, int position);
    }

    public SelectedUserAdapter(List<SelectedUser> selectedUsers, RecyclerViewUnselect listener) {
        this.mSelectedUsers = selectedUsers;
        this.mListener = listener;
    }

    @NonNull
    @Override
    public SelectedViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        // 加载你的水平列表项布局，此处省略
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_selected_user, parent, false);
        return new SelectedViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull SelectedViewHolder holder, int position) {
        SelectedUser user = mSelectedUsers.get(position);
        holder.tvName.setText(user.userName);
        // 移除按钮点击事件
        holder.btnRemove.setOnClickListener(v -> {
            mListener.onItemRemoveClick(user, position);
        });
    }

    @Override
    public int getItemCount() {
        return mSelectedUsers.size();
    }

    static class SelectedViewHolder extends RecyclerView.ViewHolder {
        TextView tvName;
        Button btnRemove;

        public SelectedViewHolder(@NonNull View itemView) {
            super(itemView);
            tvName = itemView.findViewById(R.id.tv_selected_name);
            btnRemove = itemView.findViewById(R.id.btn_remove);
        }
    }
}

4. 额外优化建议 #

• 保持垂直列表Checkbox的clickable=false，避免与item的点击事件冲突。
• 用notifyItemChanged(position)替代notifyDataSetChanged()，只刷新变化的项，提升列表性能。
• 所有状态变更都通过数据源控制，彻底规避ViewHolder复用带来的状态混乱问题。

这样修改后，就能完美实现你想要的交互效果：点击垂直列表项切换选中状态并同步到水平列表，点击水平列表项移除用户并同步取消垂直列表的选中状态，且不会出现Checkbox选中错位的问题。

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