Android RecyclerView列表项TextView自动换行异常解决方案求助

DevOps 小满

2026-8-7

Android TextView 自动换行布局问题求助

开发首款Android应用时，遇到TextView文本换行不符合预期的问题：RecyclerView的列表项模板采用RelativeLayout，包含三个TextView，预期前两个位于左侧（占视图约85%），第三个在右侧（约15%），且左侧首个TextView内容过长时能自动换行。

目前仅通过设置maxWidth能实现换行，但这种方式适配多设备效果差，属于临时方案。尝试过RelativeLayout、ConstraintLayout、TableLayout的多种组合，要么文本换行时重叠，要么不换行导致右侧的“00/00”被挤出视图。

当前XML布局代码

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">

    <!-- should be ~85% of view -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="horizontal"
        android:layout_margin="6dp"
        android:background="@drawable/list_item_border"
        android:padding="6dp">

        <LinearLayout
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:orientation="vertical">

            <!-- this text should wrap when the content is too big, but it
                 only does if I set a maxWidth which feels hacky since that
                 isn't a great multi-device solution -->
                 
            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:id="@+id/txDisplayName"
                tools:text="** I should wrap when I hit the max available space within my container **"
                android:textStyle="bold"
                android:elegantTextHeight="true"
                android:singleLine="false"
                android:minLines="1"
                android:maxLines="99"
                android:lines="3"
                android:textSize="16sp" />

            <!-- secondary item on this "row" - should always be below the TextView above -->
            <TextView
                android:layout_width="fill_parent"
                android:layout_height="wrap_content"
                android:id="@+id/txSKU"
                android:textStyle="italic"
                android:textSize="18dp"
                tools:text="00000-0000-00" />

        </LinearLayout>

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="horizontal"
            android:minWidth="30sp"
            android:gravity="right">

            <!-- should be ~15% of total view -->
            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:gravity="right"
                android:textSize="18dp"
                android:id="@+id/tvReceivingSummary"
                tools:text="00/00" />

        </LinearLayout>

    </LinearLayout>

</RelativeLayout>

边框drawable代码（@drawable/list_item_border）

<shape xmlns:android="http://schemas.android.com/apk/res/android">

    <stroke
        android:width="2dp"
        android:color="@color/prx_blue" />

    <corners android:radius="2dp" />

</shape>

预期效果

==================================================================
| Potentially long text that should always wrap when |     00/00 |
| the text gets too long. The values come from an    |           |
| API so it's not controllable text (meaning I can't |           |
| easily add "\n" because I wouldn't know where to   |           |
| separate it out.                                   |           |
==================================================================
| This is the second row - no need to wrap                       |
==================================================================

解决方案

方案1：使用LinearLayout的weight属性分配比例

通过layout_weight设置85:15的宽度比例，同时让左侧TextView填充容器空间，实现自动换行：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    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">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_margin="6dp"
        android:background="@drawable/list_item_border"
        android:padding="6dp">

        <!-- 左侧容器：占85%宽度 -->
        <LinearLayout
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="8.5"
            android:orientation="vertical">

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:id="@+id/txDisplayName"
                tools:text="** I should wrap when I hit the max available space within my container **"
                android:textStyle="bold"
                android:elegantTextHeight="true"
                android:singleLine="false"
                android:minLines="1"
                android:maxLines="99"
                android:textSize="16sp" />

            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:id="@+id/txSKU"
                android:textStyle="italic"
                android:textSize="18sp"
                tools:text="00000-0000-00" />

        </LinearLayout>

        <!-- 右侧容器：占15%宽度 -->
        <LinearLayout
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1.5"
            android:gravity="center_vertical|right"
            android:paddingLeft="8dp">

            <TextView
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:gravity="right"
                android:textSize="18sp"
                android:id="@+id/tvReceivingSummary"
                tools:text="00/00" />

        </LinearLayout>

    </LinearLayout>

</RelativeLayout>

方案2：使用ConstraintLayout（现代灵活布局）

直接通过百分比设置宽度，代码更简洁：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_margin="6dp"
    android:background="@drawable/list_item_border"
    android:padding="6dp">

    <!-- 左侧标题TextView：占85%宽度 -->
    <TextView
        android:id="@+id/txDisplayName"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:textStyle="bold"
        android:elegantTextHeight="true"
        android:singleLine="false"
        android:minLines="1"
        android:maxLines="99"
        android:textSize="16sp"
        tools:text="** I should wrap when I hit the max available space within my container **"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toLeftOf="@+id/tvReceivingSummary"
        app:layout_constraintWidth_percent="0.85" />

    <!-- SKU TextView：在标题下方 -->
    <TextView
        android:id="@+id/txSKU"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textStyle="italic"
        android:textSize="18sp"
        tools:text="00000-0000-00"
        app:layout_constraintTop_toBottomOf="@+id/txDisplayName"
        app:layout_constraintLeft_toLeftOf="parent" />

    <!-- 右侧汇总TextView：占15%宽度 -->
    <TextView
        android:id="@+id/tvReceivingSummary"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:gravity="right"
        android:textSize="18sp"
        tools:text="00/00"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintWidth_percent="0.15" />

</androidx.constraintlayout.widget.ConstraintLayout>

关键说明

外层布局layout_width必须设为match_parent，确保占满屏幕宽度。
TextView的layout_width设为match_parent（LinearLayout方案）或0dp（ConstraintLayout方案），才能让文本在容器范围内自动换行。
文字大小建议用sp单位，适配系统文字缩放设置。

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

Android RecyclerView列表项TextView自动换行异常解决方案求助

当前XML布局代码 #

边框drawable代码（@drawable/list_item_border） #

预期效果 #

解决方案 #