GridLayoutManager（spanCount=3）搭配PagerSnapHelper滚动卡顿问题求助

我之前也碰到过这个问题！PagerSnapHelper本来就是为单列/单行的RecyclerView设计的，当GridLayoutManager横向设置spanCount=3时，它还是会盯着单个item做对齐，这就导致滚动的时候得精准定位到单个item，自然就显得很费力。下面给你两种靠谱的解决办法：

解决方案1：自定义GridPagerSnapHelper（推荐） #

这种方式是直接修改SnapHelper的核心对齐逻辑，让它以**整页（3个item为一组）**为单位进行滚动对齐，体验更流畅。

自定义SnapHelper代码： #

public class GridPagerSnapHelper extends PagerSnapHelper {
    private GridLayoutManager mLayoutManager;
    private final int mSpanCount;

    public GridPagerSnapHelper(int spanCount) {
        mSpanCount = spanCount;
    }

    @Override
    public int[] calculateDistanceToFinalSnap(@NonNull RecyclerView.LayoutManager layoutManager, @NonNull View targetView) {
        mLayoutManager = (GridLayoutManager) layoutManager;
        int[] outDistance = new int[2];

        if (mLayoutManager.getOrientation() == GridLayoutManager.HORIZONTAL) {
            int currentItemPos = mLayoutManager.getPosition(targetView);
            // 计算当前item所在的页索引
            int currentPageIndex = currentItemPos / mSpanCount;
            // 目标位置是当前页的第一个item
            int targetItemPos = currentPageIndex * mSpanCount;
            View targetItemView = mLayoutManager.findViewByPosition(targetItemPos);

            if (targetItemView != null) {
                // 计算需要滚动的距离，考虑RecyclerView的左padding
                outDistance[0] = targetItemView.getLeft() - mLayoutManager.getPaddingLeft();
            }
        } else {
            // 纵向布局的情况直接用父类逻辑，这里我们只关注横向
            outDistance = super.calculateDistanceToFinalSnap(layoutManager, targetView);
        }
        return outDistance;
    }

    @Override
    public int findTargetSnapPosition(RecyclerView.LayoutManager layoutManager, int velocityX, int velocityY) {
        mLayoutManager = (GridLayoutManager) layoutManager;
        if (mLayoutManager.getOrientation() != GridLayoutManager.HORIZONTAL) {
            return super.findTargetSnapPosition(layoutManager, velocityX, velocityY);
        }

        int totalItemCount = mLayoutManager.getItemCount();
        if (totalItemCount == 0) {
            return RecyclerView.NO_POSITION;
        }

        View currentSnapView = findSnapView(layoutManager);
        if (currentSnapView == null) {
            return RecyclerView.NO_POSITION;
        }

        int currentItemPos = mLayoutManager.getPosition(currentSnapView);
        int currentPageIndex = currentItemPos / mSpanCount;

        // 根据滚动速度判断方向，确定目标页
        if (velocityX > 0) {
            // 向右滚动，跳转到下一页
            currentPageIndex++;
        } else if (velocityX < 0) {
            // 向左滚动，跳转到上一页
            currentPageIndex--;
        }

        // 处理边界，避免越界
        int targetPageIndex = Math.max(0, Math.min(currentPageIndex, (totalItemCount - 1) / mSpanCount));
        return targetPageIndex * mSpanCount;
    }
}

使用方式： #

替换原来的PagerSnapHelper即可：

GridPagerSnapHelper snapHelper = new GridPagerSnapHelper(3);
snapHelper.attachToRecyclerView(rvItemOriginalContent);
rvItemOriginalContent.setLayoutManager(new GridLayoutManager(context, 3, GridLayoutManager.HORIZONTAL, false));

解决方案2：LinearSnapHelper配合滚动监听（简易版） #

如果你不想自定义类，可以用LinearSnapHelper，再通过滚动监听在滚动停止后手动调整到整页位置，缺点是可能会有轻微的跳动感：

LinearSnapHelper snapHelper = new LinearSnapHelper();
snapHelper.attachToRecyclerView(rvItemOriginalContent);
GridLayoutManager layoutManager = new GridLayoutManager(context, 3, GridLayoutManager.HORIZONTAL, false);
rvItemOriginalContent.setLayoutManager(layoutManager);

rvItemOriginalContent.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        // 滚动停止时调整位置
        if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
            int targetPageIndex = firstVisiblePos / 3;
            int targetPos = targetPageIndex * 3;
            // 平滑滚动到目标页的第一个item
            recyclerView.smoothScrollToPosition(targetPos);
        }
    }
});

注意事项 #

• 确保所有item的宽度一致，这样整页的滚动计算才准确；如果有不同宽度的item，需要修改自定义SnapHelper的逻辑，以页面总宽度为基准计算滚动距离。
• 如果RecyclerView设置了padding或者ItemDecoration，记得在计算滚动距离时把这些偏移量考虑进去，避免对齐偏差。

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