Android Kotlin解决RecyclerView+GridLayoutManager行高不均问题

需求是实现两列布局，避免同行的item被强制拉伸到最高项的高度——当前因为ImageView使用wrap_content，默认的GridLayoutManager会让同一行的所有item高度统一为该行最高项的高度，不符合预期效果。以下是两种可行的解决方案：

方案一：使用StaggeredGridLayoutManager（推荐） #

StaggeredGridLayoutManager的默认布局逻辑是让每个item保持自身的实际高度，不会强制同行item等高，完全匹配需求。只需替换原来的GridLayoutManager即可：

修改主Activity代码： #

recyclerView = findViewById(R.id.recipesView)
// 初始化2列垂直方向的瀑布流布局管理器
val staggeredLayoutManager = StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL)
recyclerView.layoutManager = staggeredLayoutManager

recipeAdapter = RecipeAdapterClass(items)
recyclerView.adapter = recipeAdapter

优化Item布局（可选） #

原Item布局中ImageView使用固定宽度190dp，结合app:layout_constraintWidth_percent="0.5"可能在不同屏幕上出现适配问题，建议将ImageView宽度改为match_parent：

<androidx.appcompat.widget.AppCompatImageView
    android:id="@+id/recipeImage"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:scaleType="centerInside"
    android:src="@drawable/hotdog"
    android:padding="10dp"
    android:background="@drawable/card"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />

解决滚动错乱问题（可选） #

如果使用StaggeredGridLayoutManager出现item位置错乱，可在Adapter的onBindViewHolder中添加以下代码：

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    // 绑定数据的逻辑...
    
    // 确保item不会跨列
    val layoutParams = holder.itemView.layoutParams as StaggeredGridLayoutManager.LayoutParams
    layoutParams.isFullSpan = false
    holder.itemView.layoutParams = layoutParams
}

方案二：自定义GridLayoutManager（进阶） #

如果坚持使用GridLayoutManager，需要重写其测量逻辑，让每个item按自身高度布局。以下是简化的自定义实现：

class NonStretchGridLayoutManager(context: Context, spanCount: Int) : GridLayoutManager(context, spanCount) {
    override fun onMeasure(recycler: RecyclerView.Recycler, state: RecyclerView.State, widthSpec: Int, heightSpec: Int) {
        val totalHeight = calculateTotalHeight(recycler, state, widthSpec)
        super.onMeasure(recycler, state, widthSpec, View.MeasureSpec.makeMeasureSpec(totalHeight, View.MeasureSpec.EXACTLY))
    }

    private fun calculateTotalHeight(recycler: RecyclerView.Recycler, state: RecyclerView.State, widthSpec: Int): Int {
        var totalHeight = 0
        val itemCount = state.itemCount
        for (i in 0 until itemCount) {
            val view = recycler.getViewForPosition(i)
            measureChildWithMargins(view, widthSpec, 0)
            totalHeight += view.measuredHeight + (layoutParams as RecyclerView.LayoutParams).bottomMargin + (layoutParams as RecyclerView.LayoutParams).topMargin
            recycler.recycleView(view)
        }
        return totalHeight
    }
}

然后在Activity中使用这个自定义LayoutManager：

recyclerView.layoutManager = NonStretchGridLayoutManager(this, 2)

不过这种方法需要处理更多边界情况（如屏幕旋转、数据更新），因此更推荐方案一。

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