RecyclerView 无数据显示通常是因为 Adapter 的 getItemCount() 返回了 0，导致 RecyclerView 认为数据为空；本文将快速定位并修复该问题，并给出完整、健壮的 Adapter 实现建议。
recyclerview 无数据显示通常是因为 adapter 的 `getitemcount()` 返回了 0，导致 recyclerview 认为数据为空；本文将快速定位并修复该问题，并给出完整、健壮的 adapter 实现建议。
在 Android 开发中，RecyclerView 是展示列表数据的核心组件，但其“零显示”问题极为常见——既无崩溃日志，也无明显报错，界面却一片空白。从你提供的代码来看，根本原因已明确：ContactsRecViewAdapter 中 getItemCount() 方法硬编码返回 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<ContactsRecViewAdapter.ViewHolder> {
private List<Contact> contacts = new ArrayList<>();
public ContactsRecViewAdapter() {}
// 支持外部设置数据并自动刷新
public void setContacts(List<Contact> contacts) {
this.contacts = contacts != null ? contacts : new ArrayList<>();
notifyDataSetChanged(); // 确保 UI 同步更新
}
@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 不为 wrap_content（尤其在 ConstraintLayout 或 LinearLayout 中），推荐使用 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()。
