Android RecyclerView列表项间距过大问题排查及调整咨询

问题根源 #

从截图和布局代码来看，不需要调整item的padding，间距过大的核心原因是card_item_std.xml的根LinearLayout设置了android:layout_height="match_parent"——这个属性会让每个列表项强制占满RecyclerView的可用高度，导致项与项之间被过度拉伸，出现不合理的大间距。

修复步骤 #

1. 修改card_item_std.xml根布局的高度为wrap_content：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" <!-- 将match_parent改为wrap_content -->
    android:background="@color/cardview_shadow_end_color"
    android:padding="16dp"
    android:weightSum="1">

    <!-- 内部控件保持不变 -->
    <LinearLayout
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:orientation="vertical">

        <TextView
            android:id="@+id/tvId"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            tools:text="Id" />

        <TextView
            android:id="@+id/tvName"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="16sp"
            tools:text="Name" />
    </LinearLayout>
    <Button
        android:id="@+id/btnDelete"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:gravity="center_vertical"
        android:text="Delete"
        android:textAllCaps="false" />
</LinearLayout>

2. （可选）微调列表项间距
   如果修复后需要给列表项添加适度的间距，不建议直接在item布局中加margin（易导致边缘对齐问题），推荐用RecyclerView.ItemDecoration统一控制：
   在MainActivity初始化RecyclerView时添加代码：

// Kotlin示例
recyclerView.addItemDecoration(object : RecyclerView.ItemDecoration() {
    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        val position = parent.getChildAdapterPosition(view)
        // 给最后一项之外的所有项添加底部间距
        if (position != parent.adapter?.itemCount?.minus(1)) {
            outRect.bottom = resources.getDimensionPixelSize(R.dimen.item_spacing)
        }
    }
})

或Java版本：

// Java示例
recyclerView.addItemDecoration(new RecyclerView.ItemDecoration() {
    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        int position = parent.getChildAdapterPosition(view);
        if (position != parent.getAdapter().getItemCount() - 1) {
            outRect.bottom = getResources().getDimensionPixelSize(R.dimen.item_spacing);
        }
    }
});

同时在values/dimens.xml中定义间距尺寸：

<dimen name="item_spacing">8dp</dimen>

补充说明 #

• 你设置的android:padding="16dp"是控制item内部内容与边框的距离，属于合理的内边距设置，无需修改；
• activity_main.xml中的RecyclerView配置没有问题，不需要调整。

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