RecyclerView适配问题求助：横竖屏显示需求无法实现

嘿，我完全懂你这种明明按思路来但布局就是不听话的烦躁！咱们来把这个RecyclerView的响应式问题彻底解决掉，实现竖屏全显不滚动、横屏可滚动的效果。

核心思路 #

本质上就是根据屏幕方向动态控制RecyclerView的高度和滚动特性：

• 竖屏时：让RecyclerView的高度刚好能放下全部15个CardView，同时禁用滚动
• 横屏时：让RecyclerView占满屏幕高度，超出部分自然滚动

方案一：用资源文件区分横竖屏（最简单） #

Android本身支持通过不同资源目录适配横竖屏，这是最省心的方式：

1. 创建竖屏布局（res/layout/activity_your.xml）：

<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" <!-- 自动适配全部item高度 -->
        app:layout_constraintTop_toTopOf="parent"
        app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
        app:spanCount="3" /> <!-- 竖屏3列，5行刚好15个 -->

</androidx.constraintlayout.widget.ConstraintLayout>

2. 创建横屏布局（res/layout-land/activity_your.xml）：

<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" <!-- 占满屏幕，超出滚动 -->
        app:layout_constraintTop_toTopOf="parent"
        app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
        app:spanCount="5" /> <!-- 横屏可以设更多列，比如5列3行 -->

</androidx.constraintlayout.widget.ConstraintLayout>

3. 关键前提：确保你的RecyclerView依赖是最新版本（至少1.3.0+），旧版本不支持wrap_content的正确测量：

implementation 'androidx.recyclerview:recyclerview:1.3.2'

方案二：代码动态控制（更灵活） #

如果需要更复杂的逻辑（比如根据屏幕尺寸动态调整列数），可以用代码监听屏幕方向变化：

1. 布局文件（通用横竖屏）：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:layoutManager="androidx.recyclerview.widget.GridLayoutManager" />

2. Kotlin代码实现：

class YourActivity : AppCompatActivity() {
    private lateinit var recyclerView: RecyclerView
    private lateinit var gridLayoutManager: GridLayoutManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_your)

        recyclerView = findViewById(R.id.recyclerView)
        gridLayoutManager = GridLayoutManager(this, 3) // 默认竖屏3列
        recyclerView.layoutManager = gridLayoutManager
        recyclerView.adapter = YourCardAdapter(get15Items()) // 你的适配器

        // 首次加载时调整布局
        adjustRecyclerViewForOrientation(resources.configuration.orientation)

        // 监听布局完成，确保item高度测量准确
        recyclerView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
            override fun onGlobalLayout() {
                recyclerView.viewTreeObserver.removeOnGlobalLayoutListener(this)
                adjustRecyclerViewForOrientation(resources.configuration.orientation)
            }
        })
    }

    // 处理屏幕旋转
    override fun onConfigurationChanged(newConfig: Configuration) {
        super.onConfigurationChanged(newConfig)
        adjustRecyclerViewForOrientation(newConfig.orientation)
    }

    private fun adjustRecyclerViewForOrientation(orientation: Int) {
        if (orientation == Configuration.ORIENTATION_PORTRAIT) {
            // 竖屏设置：3列，高度适配全部item，禁用滚动
            gridLayoutManager.spanCount = 3
            val itemHeight = recyclerView.getChildAt(0)?.height ?: dipToPx(150) // fallback到默认高度
            val totalRows = 15 / 3 // 5行
            val totalHeight = itemHeight * totalRows

            recyclerView.layoutParams.height = totalHeight
            recyclerView.isNestedScrollingEnabled = false // 禁止滚动
        } else {
            // 横屏设置：5列，高度占满屏幕，允许滚动
            gridLayoutManager.spanCount = 5
            recyclerView.layoutParams.height = ViewGroup.LayoutParams.MATCH_PARENT
            recyclerView.isNestedScrollingEnabled = true // 允许滚动
        }
        gridLayoutManager.requestLayout()
    }

    // 辅助方法：dp转px
    private fun dipToPx(dp: Int): Int {
        return (dp * resources.displayMetrics.density).toInt()
    }

    // 模拟获取15个数据项
    private fun get15Items(): List<YourDataModel> {
        return List(15) { YourDataModel("Item $it") }
    }
}

3. 配置AndroidManifest：避免屏幕旋转时重建Activity，添加configChanges属性：

<activity
    android:name=".YourActivity"
    android:configChanges="orientation|screenSize|smallestScreenSize">
</activity>

常见坑点排查 #

• 如果竖屏还是滚动：检查CardView的布局是否有match_parent的高度，或者RecyclerView版本是否太旧不支持wrap_content
• 如果横屏不滚动：确保RecyclerView的高度是match_parent，且item总高度超过屏幕高度
• 屏幕旋转后布局错乱：一定要在onConfigurationChanged中重新更新布局参数和列数

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