RecyclerView单选函数复用问题及IDE变量提示报错解决

你的问题核心在于单选状态没有和每个RecyclerView实例绑定：

• 当选中变量定义在函数内部时，每次调用函数都会生成新的局部变量，单列表场景下状态独立没问题，但多列表复用会导致不同列表的选中状态互相覆盖；
• 盲目设置final变量时，大概率是变量未完成初始化就被Lambda或其他逻辑引用，直接触发空指针异常。

方案1：用Map为每个RecyclerView绑定独立选中状态 #

通过HashMap将选中位置与RecyclerView实例关联，确保每个列表的状态独立：

// 类成员变量，存储每个RecyclerView的选中位置（默认-1表示未选中）
private HashMap<RecyclerView, Integer> rvSelectedMap = new HashMap<>();

public void setRecyclerViewSingleItems(RecyclerView recyclerView, YourAdapter adapter) {
    // 初始化当前RecyclerView的选中状态
    rvSelectedMap.putIfAbsent(recyclerView, -1);

    adapter.setOnItemClickListener(position -> {
        int oldPos = rvSelectedMap.get(recyclerView);
        // 更新当前列表的选中位置
        rvSelectedMap.put(recyclerView, position);
        
        // 刷新UI：先重置旧选中项，再高亮新选中项
        if (oldPos != -1) {
            adapter.notifyItemChanged(oldPos);
        }
        adapter.notifyItemChanged(position);
    });

    // 通用配置：设置LayoutManager等
    recyclerView.setLayoutManager(new LinearLayoutManager(recyclerView.getContext()));
    recyclerView.setAdapter(adapter);
}

配套Adapter需要支持点击回调和选中UI更新：

public class YourAdapter extends RecyclerView.Adapter<YourAdapter.ViewHolder> {
    private List<YourItem> itemList;
    private OnItemClickListener clickListener;

    public interface OnItemClickListener {
        void onItemClick(int position);
    }

    public void setOnItemClickListener(OnItemClickListener listener) {
        this.clickListener = listener;
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        YourItem item = itemList.get(position);
        // 这里可以通过外部传入的选中位置判断是否高亮，或者直接从Map中获取
        holder.itemView.setSelected(/* 选中判断逻辑 */);
        
        holder.itemView.setOnClickListener(v -> {
            if (clickListener != null) {
                clickListener.onItemClick(position);
            }
        });
    }

    // 构造方法、ViewHolder定义等省略
}

方案2：让Adapter内置选中状态（更推荐，解耦彻底） #

将单选逻辑封装到Adapter内部，每个Adapter实例独立维护自己的选中位置，完全避免多列表状态冲突：

public class SingleSelectAdapter extends RecyclerView.Adapter<SingleSelectAdapter.ViewHolder> {
    private List<YourItem> itemList;
    private int selectedPosition = -1; // 每个Adapter实例独有的选中状态

    public SingleSelectAdapter(List<YourItem> itemList) {
        this.itemList = itemList;
    }

    // 对外提供更新选中位置的方法
    public void updateSelectedPosition(int newPos) {
        int oldPos = this.selectedPosition;
        this.selectedPosition = newPos;
        // 仅刷新需要变更的项，提升性能
        if (oldPos != -1) notifyItemChanged(oldPos);
        notifyItemChanged(newPos);
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        YourItem item = itemList.get(position);
        // 直接根据当前Adapter的选中状态更新UI
        holder.itemView.setSelected(position == selectedPosition);
        
        holder.itemView.setOnClickListener(v -> updateSelectedPosition(position));
    }

    // 构造方法、ViewHolder定义等省略
}

此时复用函数变得极度简洁，无需处理状态冲突：

public void setRecyclerViewSingleItems(RecyclerView recyclerView, SingleSelectAdapter adapter) {
    recyclerView.setLayoutManager(new LinearLayoutManager(recyclerView.getContext()));
    recyclerView.setAdapter(adapter);
}

关于final变量引发空指针的说明 #

你设置final变量后触发空指针，通常是以下两种情况：

1. final变量未初始化就被Lambda表达式引用（Lambda会捕获final变量的初始值）；
2. 误用全局final变量存储选中位置，多列表场景下变量被频繁覆盖，导致后续逻辑引用到无效值。

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