如何实现RecyclerView横向双向无限循环滚动？

我明白你现在的困境——想做一个能左右双向无限循环的RecyclerView，目前向右滚动没问题，但向左滚动循环不生效，而且用Integer.MAX_VALUE做条目总数时，点击条目又会拿到错误的位置。咱们一步步来拆解解决这个问题。

先分析你现有代码的核心问题 #

1. 原2倍条目数的局限：你最初用Items.size() * 2作为条目总数，这个数量太少，向左滚动几次就会触顶，根本无法实现真正的无限循环。
2. 点击位置错误的根源：用Integer.MAX_VALUE时，getAdapterPosition()返回的是超大的虚拟位置，直接用这个值去取原列表Items的元素，肯定会越界或者取错数据，必须先转换成真实的原数据索引。
3. 滚动监听逻辑不完善：原监听只处理了firstVisibleItemPos == 0的情况，但没有结合滚动方向判断，也没有设置合理的跳转目标位置，导致向左滚动循环失效。

完整解决方案代码 #

第一步：修改Adapter，处理索引转换和点击事件

public class InfiniteLoopAdapter extends RecyclerView.Adapter<InfiniteLoopAdapter.ViewHolder> {
    private List<Item> items;
    private Item currentlySelectedItem; // 你的选中项变量

    public InfiniteLoopAdapter(List<Item> items) {
        this.items = items;
    }

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        // 替换成你的布局加载逻辑
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.your_item_layout, parent, false);
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(ViewHolder viewHolder, int position) {
        // 核心：将虚拟位置转换为真实数据索引
        int realPosition = position % items.size();
        Item item = items.get(realPosition);
        
        // 这里写你的数据绑定逻辑，比如设置文本、图片等
        viewHolder.itemTextView.setText(item.getTitle());
        
        // 处理选中状态（如果需要）
        viewHolder.itemView.setSelected(item.equals(currentlySelectedItem));
    }

    @Override
    public int getItemCount() {
        // 用Integer.MAX_VALUE实现无限滚动的基础
        return items == null ? 0 : Integer.MAX_VALUE;
    }

    public class ViewHolder extends RecyclerView.ViewHolder {
        TextView itemTextView;

        public ViewHolder(View itemView) {
            super(itemView);
            itemTextView = itemView.findViewById(R.id.item_text);

            // 修正点击事件的位置获取逻辑
            itemView.setOnClickListener(v -> {
                int adapterPos = getAdapterPosition();
                // 先判断位置是否有效
                if (adapterPos == RecyclerView.NO_POSITION) return;
                
                // 转换为真实索引
                int realPos = adapterPos % items.size();
                currentlySelectedItem = items.get(realPos);
                notifyDataSetChanged();
            });
        }
    }
}

第二步：完善滚动监听，实现双向循环

// 初始化RecyclerView
RecyclerView recyclerView = findViewById(R.id.horizontal_recycler);
LinearLayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false);
recyclerView.setLayoutManager(layoutManager);
InfiniteLoopAdapter adapter = new InfiniteLoopAdapter(yourItemList);
recyclerView.setAdapter(adapter);

// 关键：初始滚动到中间位置，避免一开始向左滚动就触发跳转
int itemCount = yourItemList.size();
int initialPosition = Integer.MAX_VALUE / 2 - (Integer.MAX_VALUE / 2 % itemCount);
layoutManager.scrollToPosition(initialPosition);

// 添加滚动监听处理循环逻辑
recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        if (itemCount == 0) return;

        int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
        int lastVisiblePos = layoutManager.findLastVisibleItemPosition();

        // 向左滚动（dx < 0），且第一个可见条目触顶时，跳转到对应大位置实现循环
        if (dx < 0 && firstVisiblePos == 0) {
            int targetPos = Integer.MAX_VALUE / 2 - (Integer.MAX_VALUE / 2 % itemCount);
            layoutManager.scrollToPosition(targetPos);
            // 修正滚动偏移，避免跳转后位置突变
            recyclerView.scrollBy(dx, 0);
        }
        // 向右滚动（dx > 0），且最后一个可见条目接近末尾时，跳转到中间位置
        else if (dx > 0 && lastVisiblePos >= Integer.MAX_VALUE - itemCount) {
            int targetPos = Integer.MAX_VALUE / 2;
            layoutManager.scrollToPosition(targetPos);
            recyclerView.scrollBy(dx, 0);
        }
    }
});

关键要点解释 #

1. 索引转换逻辑：不管是onBindViewHolder还是点击事件，都用position % items.size()将虚拟位置转换成真实的原数据索引，这是解决点击位置错误和数据绑定错误的核心。
2. 初始位置设置：一开始滚动到Integer.MAX_VALUE/2附近的位置，这样不管向左还是向右滚动，都有足够的虚拟条目空间，不会一开始就触发跳转逻辑。
3. 滚动方向判断：通过dx的值判断滚动方向（dx<0向左，dx>0向右），分别处理触顶和触底的跳转，同时用scrollBy修正偏移，让滚动更流畅，没有突兀的跳转感。

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