RecyclerView 加载列表后一片空白、没有任何数据项显示时，最常见的原因就是 Adapter 的 getItemCount() 方法返回了 0，导致 RecyclerView 判断数据为空从而跳过渲染。本文帮助你快速定位并解决该问题，并提供一套健壮且易维护的 Adapter 实现方案。

在 Android 日常开发中，RecyclerView 几乎是列表场景的标配组件，但“列表加载不出来”的故障极为常见——没有崩溃日志、没有明显报错，界面就是一片空白。根据大量实战案例来看，问题的根源往往集中在 Adapter 的 getItemCount() 方法上：ContactsRecViewAdapter 中硬编码返回了 0，RecyclerView 自然跳过了所有数据绑定流程，导致列表“静默失效”。

问题定位与修复

关键错误就藏在 ContactsRecViewAdapter.java 里：

@Override
public int getItemCount() {
    return 0; // ❌ 始终返回 0，不管 contacts 有没有数据
}

正确的做法很直接，动态返回实际数据集合的大小：

@Override
public int getItemCount() {
    return contacts.size(); // ✅ 返回真实数据数量
}

只需修改这一行代码，列表就能初步显示出来。但要让它运行更稳定、维护更轻松，建议对 Adapter 做一次更彻底的优化改造。

增强版 Adapter 实现（空安全 + 刷新支持）

public class ContactsRecViewAdapter extends RecyclerView.Adapter {
    private List contacts = new ArrayList<>();
    
    public ContactsRecViewAdapter() {}
    
    // 外部设置数据时自动刷新UI
    public void setContacts(List contacts) {
        this.contacts = contacts != null ? contacts : new ArrayList<>();
        notifyDataSetChanged();
    }
    
    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.contacts_list_item, parent, false);
        return new ViewHolder(view);
    }
    
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        Contact contact = contacts.get(position);
        holder.txtName.setText(contact.getName());
        // 后续可扩展：设置 email、加载头像（推荐用 Glide / Picasso）
    }
    
    @Override
    public int getItemCount() {
        return contacts.size(); // ✅ 动态返回
    }
    
    static class ViewHolder extends RecyclerView.ViewHolder {
        TextView txtName;
        ViewHolder(@NonNull View itemView) {
            super(itemView);
            txtName = itemView.findViewById(R.id.txtName);
        }
    }
}

其他容易忽略的检查点

• 布局管理器必须设置：你的 MainActivity 里已经正确配置了 LinearLayoutManager，这一步没问题。
• RecyclerView 高度别用 wrap_content：检查 activity_main.xml 中 RecyclerView 的 android:layout_height，避免在 ConstraintLayout 或 LinearLayout 里使用 wrap_content，推荐 0dp 加权重或者 match_parent。
• Item 布局的根视图宽高要合理：contacts_list_item.xml 的根布局必须设置 android:layout_width="match_parent" 和 android:layout_height="wrap_content"。
• 数据非空验证：可以在 onCreate() 里加日志确认：

  Log.d("RecyclerView", "Contact count: " + contacts.size()); // 应该输出5

总结

getItemCount() 返回 0 是 RecyclerView 出现“空白列表”最经典的元凶。修复之后，配合 notifyDataSetChanged()（或更高效的 submitList() + ListAdapter），稳定渲染就不成问题。进阶建议：使用 ListAdapter + DiffUtil 提升性能，用 Glide 加载头像，避免主线程阻塞。

现在运行应用，你将看到完整的《黑道家族》角色列表——一切只因为一个被遗忘的 .size()。