Flutter中如何实现ListView内容自动换行且无横向滚动？

Android 平台实现 #

• 确保ListView宽度适配父容器：设置android:layout_width="match_parent"，并移除横向滚动相关属性（如android:scrollbars="horizontal"）。
• 列表项(Item)根布局宽度设为match_parent，保证内容能占满屏幕宽度。
• 文本控件（TextView）配置：
  • android:layout_width="match_parent"
  • android:singleLine="false"（允许多行）
  • android:ellipsize="none"（不省略文本）

示例代码：

<!-- ListView 布局 -->
<ListView
    android:id="@+id/my_list"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scrollbars="none" />

<!-- 列表项布局 -->
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="12dp">

    <TextView
        android:id="@+id/item_content"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="这里是一段超长的文本内容，当宽度占满屏幕时会自动换行显示，不会触发横向滚动"
        android:singleLine="false"
        android:ellipsize="none" />
</LinearLayout>

Flutter 平台实现 #

• ListView保持默认垂直滚动方向（scrollDirection: Axis.vertical），无需额外设置。
• 列表项宽度设为double.infinity，占满可用空间。
• 文本组件默认支持自动换行（softWrap: true为默认值），无需额外配置；若使用多元素布局，用Wrap组件实现自动换行。

示例代码：

// 纯文本列表项
ListView.builder(
  itemCount: 5,
  itemBuilder: (context, index) {
    return Container(
      width: double.infinity,
      padding: const EdgeInsets.all(12),
      child: Text(
        '第${index+1}条内容：这是一段需要自动换行的超长文本，宽度占满后会自动切换到下一行，完全不需要横向滚动',
      ),
    );
  },
);

// 多元素自动换行的列表项
ListView.builder(
  itemCount: 5,
  itemBuilder: (context, index) {
    return Wrap(
      width: double.infinity,
      spacing: 8,
      runSpacing: 4,
      padding: const EdgeInsets.all(12),
      children: [
        const Chip(label: Text('标签A')),
        const Chip(label: Text('标签B')),
        const Chip(label: Text('很长的标签内容，占满宽度后自动换行')),
        const Chip(label: Text('标签D')),
      ],
    );
  },
);

通用注意事项 #

• 禁止给控件设置强制单行的属性（如Android的singleLine="true"、Flutter的softWrap: false）。
• 确保ListView的父容器宽度是填满可用空间的，避免因父容器过窄导致内容无法换行。

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