如何让带自定义首项的RecyclerView首项高度适配屏幕尺寸

我之前也碰到过一模一样的情况——用StaggeredGridLayoutManager的时候，布局编辑器里首项明明能填满屏幕，一运行就缩成只适配内容的高度。其实问题出在StaggeredGridLayoutManager的测量逻辑上：它默认会根据子项内容自动调整高度，完全忽略你写的match_parent，而布局编辑器是静态渲染，不会走这个动态测量流程，所以才会出现这种差异。

下面给你几个亲测有效的解决步骤：

1. 强制设置首项高度为屏幕高度 #

在你的RecyclerView Adapter里，找到绑定首项的逻辑，手动获取屏幕高度并覆盖布局参数：

override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) {
    // 判断当前是首项位置
    if (position == 0) {
        // 获取屏幕实际高度
        val displayMetrics = holder.itemView.context.resources.displayMetrics
        val screenHeight = displayMetrics.heightPixels
        
        // 更新首项布局高度
        val layoutParams = holder.itemView.layoutParams
        layoutParams.height = screenHeight
        holder.itemView.layoutParams = layoutParams
    }
    
    // 其他子项的绑定逻辑...
}

2. 让首项占满瀑布流整行 #

因为你用的是StaggeredGridLayoutManager，首项需要设置fullSpan才能占满整行宽度，否则可能出现宽度不足的情况：

override fun onViewAttachedToWindow(holder: RecyclerView.ViewHolder) {
    super.onViewAttachedToWindow(holder)
    // 判断当前是首项的ViewHolder
    if (holder is HeaderViewHolder) {
        val staggeredParams = holder.itemView.layoutParams as StaggeredGridLayoutManager.LayoutParams
        staggeredParams.isFullSpan = true
    }
}

3. 检查首项布局的细节 #

确认你的首项根布局确实是android:layout_height="match_parent"，并且没有嵌套布局设置了固定高度或者多余的margin/padding——这些小细节都可能导致高度被意外压缩。你给出的LinearLayout布局是没问题的，只要保证没有其他层级干扰就行。

做完这几步，运行起来首项应该就能完美占满整个屏幕，和编辑器里的显示效果一致了。

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