RecyclerView自定义ItemDecoration添加首尾间距异常如何解决

你自定义ItemDecoration出现两类异常的核心错误有两个：

• 错误使用parent.getChildCount()获取列表总长度：这个方法返回的是当前屏幕上挂载的可见子View数量，不是Adapter绑定的总条目数。列表滚动时子View会动态复用、增减，自然会把末尾间距错误加到当前屏幕可见的最后一个item上。
• 没有重置outRect的旧值，也没有处理普通item之间的默认间距：View复用时会保留上一次绑定位置设置的偏移值，初始加载阶段子View挂载顺序不稳定，就会出现间距随机出现的问题。

正确实现需要遵循三个规则：

• 列表总条目数必须通过parent.getAdapter().getItemCount()获取
• 每次计算偏移前先清空outRect的残留值，跳过无效position的View
• 把首尾额外间距、普通item之间的默认间距逻辑统一放到ItemDecoration中处理，item布局本身不要加左右margin，避免间距叠加

修复后的完整代码如下：

public class HorizontalItemDecoration extends RecyclerView.ItemDecoration {
    private final int edgeSpaceWidth; // 首尾位置的额外间距，对应16dp
    private final int normalItemGap; // 普通item之间的默认间距，对应4dp

    public HorizontalItemDecoration(int edgeSpaceWidth, int normalItemGap) {
        this.edgeSpaceWidth = edgeSpaceWidth;
        this.normalItemGap = normalItemGap;
    }

    @Override
    public void getItemOffsets(@NonNull Rect outRect, @NonNull View view, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        // 先清空所有历史偏移值，避免复用时间距错乱
        outRect.set(0, 0, 0, 0);
        int currentPos = parent.getChildAdapterPosition(view);
        // 跳过正在执行动画、position无效的View
        if (currentPos == RecyclerView.NO_POSITION) return;

        int totalCount = parent.getAdapter().getItemCount();
        if (currentPos == 0) {
            // 第一个item：左侧加首尾间距，右侧加普通item间距
            outRect.left = edgeSpaceWidth;
            outRect.right = normalItemGap;
        } else if (currentPos == totalCount - 1) {
            // 最后一个item：右侧加首尾间距，左侧不用重复加间距（前一个item已经设置了右间距）
            outRect.right = edgeSpaceWidth;
        } else {
            // 中间普通item：只加右侧普通间距
            outRect.right = normalItemGap;
        }
    }
}

• 传参前需要把dp值转为对应像素值，避免间距尺寸错误：

  int edgeSpace = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 16, getResources().getDisplayMetrics());
  int normalGap = TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP, 4, getResources().getDisplayMetrics());
  recyclerView.addItemDecoration(new HorizontalItemDecoration(edgeSpace, normalGap));
  

• 不需要给RecyclerView设置paddingLeft/paddingRight，也不需要开启clipToPadding=false，该实现可以直接满足首尾item滚动到屏幕边缘的需求
• 如果后续要修改间距规则，直接在getItemOffsets里调整对应position的outRect值即可，不需要改动item布局文件

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