Android开发：CardView内ImageView与TextView并排显示异常排查

在CardView中实现ImageView与TextView并排显示，设计界面显示效果正常，但应用运行时ImageView变得过大，占据大部分空间，导致TextView无法正常显示。

涉及布局代码 #

item_offer_list.xml（RecyclerView子项布局） #

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView 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"
    android:layout_marginLeft="4dp"
    android:layout_marginTop="4dp"
    android:layout_marginRight="4dp"
    android:layout_marginBottom="8dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        tools:ignore="UseCompoundDrawables">

        <ImageView
            android:id="@+id/cv_iv_photo_poster"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:contentDescription="null"
            tools:src="@drawable/ic_launcher_background" />

        <TextView
            android:id="@+id/txtTitle"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:layout_toEndOf="@+id/cv_iv_photo_poster"
            android:gravity="center"
            android:text="@string/app_name">
        </TextView>
    </LinearLayout>

</androidx.cardview.widget.CardView>

RecyclerView所在布局 #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    tools:context=".OfferWallListFragment">

    <LinearLayout
        android:id="@+id/llRecyclerLayout"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_constraintTop_toTopOf="parent"
        android:orientation="horizontal">

        <ProgressBar
            android:id="@+id/pbLoadingItems"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center"
            android:visibility="gone" />

        <TextView
            android:id="@+id/txtNoConnection"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_gravity="center"
            android:gravity="center"
            android:visibility="gone"
            tools:text="No Internet Connection" />

        <androidx.recyclerview.widget.RecyclerView
            android:id="@+id/rv_OfferData"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_margin="4dp"
            android:visibility="visible"
            tools:listitem="@layout/item_offer_list">
        </androidx.recyclerview.widget.RecyclerView>
    </LinearLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

原因分析 #

1. ImageView尺寸无约束：ImageView使用wrap_content作为宽高，运行时加载的图片原始尺寸过大，LinearLayout为水平方向时，ImageView会优先占据所有可用空间，挤压TextView的显示区域。
2. 无效布局属性：TextView中的android:layout_toEndOf="@+id/cv_iv_photo_poster"是ConstraintLayout专属属性，在LinearLayout中完全不起作用，无法实现“TextView在ImageView右侧”的布局约束。
3. RecyclerView父布局方向错误：RecyclerView所在的LinearLayout设置为horizontal（水平）方向，导致内部的ProgressBar、TextView、RecyclerView会横向排列，不符合垂直列表的预期布局逻辑。

解决方案 #

1. 修正子项布局（item_offer_list.xml） #

给ImageView设置固定尺寸或比例约束，同时移除无效属性：

方案A：固定ImageView宽高（推荐，适合固定图标场景）

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView 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"
    android:layout_marginLeft="4dp"
    android:layout_marginTop="4dp"
    android:layout_marginRight="4dp"
    android:layout_marginBottom="8dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:gravity="center_vertical"
        tools:ignore="UseCompoundDrawables">

        <ImageView
            android:id="@+id/cv_iv_photo_poster"
            android:layout_width="80dp"
            android:layout_height="80dp"
            android:contentDescription="@null"
            android:scaleType="centerCrop"
            tools:src="@drawable/ic_launcher_background" />

        <TextView
            android:id="@+id/txtTitle"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginStart="16dp"
            android:gravity="center_vertical"
            android:text="@string/app_name" />
    </LinearLayout>

</androidx.cardview.widget.CardView>

• 给ImageView设置固定宽高（如80dp），并添加scaleType保证图片按比例显示，避免拉伸变形。
• 移除TextView无效的layout_toEndOf属性，添加layout_marginStart让文本和图片保持间距。
• 给LinearLayout添加gravity="center_vertical"，让控件垂直居中对齐。

方案B：按比例分配空间（适合需要自适应宽度的场景）

<?xml version="1.0" encoding="utf-8"?>
<androidx.cardview.widget.CardView 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"
    android:layout_marginLeft="4dp"
    android:layout_marginTop="4dp"
    android:layout_marginRight="4dp"
    android:layout_marginBottom="8dp">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:gravity="center_vertical"
        tools:ignore="UseCompoundDrawables">

        <ImageView
            android:id="@+id/cv_iv_photo_poster"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:contentDescription="@null"
            android:scaleType="centerCrop"
            tools:src="@drawable/ic_launcher_background" />

        <TextView
            android:id="@+id/txtTitle"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="3"
            android:layout_marginStart="16dp"
            android:gravity="center_vertical"
            android:text="@string/app_name" />
    </LinearLayout>

</androidx.cardview.widget.CardView>

• 通过layout_weight分配空间，ImageView占1份，TextView占3份，确保两者按比例显示。
• ImageView宽设置为0dp，让LinearLayout根据weight计算实际宽度。

2. 修正RecyclerView父布局 #

将RecyclerView所在LinearLayout的方向改为垂直：

<LinearLayout
    android:id="@+id/llRecyclerLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:layout_constraintTop_toTopOf="parent"
    android:orientation="vertical">

这样ProgressBar、TextView、RecyclerView会垂直排列，符合列表加载、空状态的布局逻辑。

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