如何解决GridLayoutManager的RecyclerView日历布局滚动空白异常？

你的问题根源在于RecyclerView的ViewHolder复用机制与View显示状态切换冲突：当你设置View.GONE后，复用的ViewHolder可能没有被正确重置为VISIBLE，加上GridLayoutManager对不可见item的布局计算逻辑，导致滚动时出现随机空白或显示错乱。以下是三种可靠的优化方案：

方案一：填充占位项到数据源（最直观稳定） #

直接在日期数据的开头添加firstItemLocation个占位对象，让RecyclerView的每个item都处于可见状态，避免显示/隐藏的状态切换。

实现步骤： #

1. 初始化数据源时，先添加对应数量的占位项：

// 假设原日期列表为listOfDays，firstItemLocation是当月第一天的偏移位置
List<Integer> calendarData = new ArrayList<>();
// 添加占位项
for (int i = 0; i < firstItemLocation; i++) {
    calendarData.add(null); // 用null标记占位项
}
// 添加当月日期
calendarData.addAll(listOfDays);

2. 在适配器的onBindViewHolder中直接处理：

@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    Integer day = calendarData.get(position);
    if (day == null) {
        // 占位项：显示空内容，保持View可见
        holder.tv.setText("");
    } else {
        holder.tv.setText(String.format(Locale.US, "%d", day));
    }
}

这种方式彻底避免了View状态切换，ViewHolder复用逻辑完全正常，不会出现滚动异常。

方案二：使用多类型ViewHolder隔离占位项与日期项 #

通过getItemViewType为占位项和日期项设置不同类型，让RecyclerView为不同类型的ViewHolder单独维护复用池，避免状态污染。

实现步骤： #

1. 定义两种item类型：

private static final int TYPE_EMPTY = 0;
private static final int TYPE_DATE = 1;

2. 重写getItemViewType：

@Override
public int getItemViewType(int position) {
    return position < firstItemLocation ? TYPE_EMPTY : TYPE_DATE;
}

3. 在onCreateViewHolder中创建对应类型的ViewHolder：

@NonNull
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
    View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_calendar, parent, false);
    if (viewType == TYPE_EMPTY) {
        // 占位项ViewHolder：设置空内容并禁用交互
        TextView tv = view.findViewById(R.id.tv_day);
        tv.setText("");
        view.setClickable(false);
        return new ViewHolder(view);
    } else {
        return new ViewHolder(view);
    }
}

4. 在onBindViewHolder中根据类型处理：

@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
    if (holder.getItemViewType() == TYPE_DATE) {
        int dayIndex = position - firstItemLocation;
        holder.tv.setText(String.format(Locale.US, "%d", listOfDays.get(dayIndex)));
    }
}

方案三：用ItemDecoration实现偏移（无占位项，更优雅） #

如果不想修改数据源，可以通过自定义ItemDecoration为第一个日期item添加左侧偏移量，直接实现视觉上的位置偏移，无需占位项。

实现步骤： #

1. 自定义ItemDecoration：

public class CalendarOffsetDecoration extends RecyclerView.ItemDecoration {
    private int firstItemLocation;
    private int itemWidth;

    public CalendarOffsetDecoration(int firstItemLocation, int itemWidth) {
        this.firstItemLocation = firstItemLocation;
        this.itemWidth = itemWidth;
    }

    @Override
    public void getItemOffsets(@NonNull Rect outRect, @NonNull View view, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        super.getItemOffsets(outRect, view, parent, state);
        int position = parent.getChildAdapterPosition(view);
        // 为第一个日期item添加左侧偏移
        if (position == firstItemLocation) {
            outRect.left = firstItemLocation * itemWidth;
        }
    }
}

2. 计算item宽度并添加Decoration到RecyclerView：

// 假设GridLayoutManager是7列（一周7天）
int spanCount = 7;
GridLayoutManager layoutManager = new GridLayoutManager(this, spanCount);
recyclerView.setLayoutManager(layoutManager);

// 计算单个item的宽度：RecyclerView宽度除以列数
int recyclerViewWidth = getResources().getDisplayMetrics().widthPixels;
int itemWidth = recyclerViewWidth / spanCount;

// 添加Decoration
recyclerView.addItemDecoration(new CalendarOffsetDecoration(firstItemLocation, itemWidth));

这种方式不需要修改数据源或处理ViewHolder状态，适合追求简洁布局逻辑的场景，但需要注意屏幕旋转时重新计算item宽度和偏移量。

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