如何让RecyclerView中的ImageView宽度适配父布局？

问题背景 #

使用RecyclerView实现图片列表，需求是让列表项中的ImageView宽度完全适配父布局宽度，但尝试包括设置scaleType="centerCrop"在内的多种方式后均未达到预期效果。

现有代码 #

RecyclerView布局

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/adsRV_AD"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:overScrollMode="never"
        android:clipToPadding="false" />
</layout>

列表项布局

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <androidx.appcompat.widget.AppCompatImageView
        android:id="@+id/icon"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:scaleType="fitXY"
        android:background="@drawable/bg_rounded_img"
        android:outlineProvider="background"
        android:src="@drawable/booknow"
        android:adjustViewBounds="true" />
</layout>

当前效果 #

解决步骤 #

1. 确认RecyclerView的LayoutManager配置 #

检查代码中RecyclerView的LayoutManager设置，确保使用LinearLayoutManager且方向为垂直，未设置错误的宽度限制：

// Kotlin示例
val layoutManager = LinearLayoutManager(context, LinearLayoutManager.VERTICAL, false)
adsRV_AD.layoutManager = layoutManager

2. 给列表项添加根布局约束 #

直接使用ImageView作为列表项根布局可能导致测量异常，包裹一层父布局（如ConstraintLayout）并设置宽度为match_parent：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">
        
        <androidx.appcompat.widget.AppCompatImageView
            android:id="@+id/icon"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:src="@drawable/booknow"
            android:scaleType="centerCrop"
            android:adjustViewBounds="true"
            android:background="@drawable/bg_rounded_img"
            android:outlineProvider="background"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintEnd_toEndOf="parent"/>
    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

3. 优化ImageView属性组合 #

• 替换scaleType="fitXY"为centerCrop：既保证图片填满宽度，又维持原有比例，避免拉伸变形
• 保留adjustViewBounds="true"：让ImageView根据图片比例自动调整高度
• 确保layout_width="match_parent"、layout_height="wrap_content"的基础设置

4. 检查RecyclerView的padding配置 #

若RecyclerView设置了android:clipToPadding="false"，同时存在左右padding，会导致列表项显示不全。如果不需要左右padding，可直接移除该属性；若需要padding，需确保列表项布局不受padding干扰。

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