在含ScrollView的XML中添加<include>布局报错，该如何解决？

这个问题我太熟悉了！其实就是踩了ScrollView的经典限制——它只能拥有一个直接子视图/布局。你直接把<include layout="@layout/titlebar"/>放在ScrollView下时，相当于ScrollView同时持有了这个复用布局和原本的内容布局（如果有的话），多个直接子节点就会触发ScrollView can host only one direct child的渲染异常。

正确的做法是：给ScrollView套一个唯一的容器布局 #

你需要先在ScrollView内部添加一个容器（比如LinearLayout、ConstraintLayout这类布局容器），把所有内容（包括复用的titlebar）都放到这个容器里，让ScrollView只直接持有这一个容器。

举个错误写法和修正后的对比：

❌ 错误写法（触发异常）

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 直接放在ScrollView下，和下面的TextView成为同级直接子节点 -->
    <include layout="@layout/titlebar"/>

    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="滚动内容"/>

</ScrollView>

✅ 正确写法

用一个垂直方向的LinearLayout作为ScrollView的唯一直接子容器，把复用布局和其他内容都放进去：

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 唯一的直接子容器：LinearLayout -->
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical">

        <!-- 复用的titlebar放在容器内部 -->
        <include layout="@layout/titlebar"/>

        <!-- 所有滚动内容都放在这个容器里 -->
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="滚动内容第一行"/>
        <TextView
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="滚动内容第二行"/>
        <!-- 更多内容... -->

    </LinearLayout>

</ScrollView>

额外提示 #

• 如果你的ScrollView里原本就有一个容器布局（比如已经用了ConstraintLayout），那直接把<include>标签插入到这个容器的合适位置（比如顶部）即可，不用额外再新建容器。
• 容器布局的选择：垂直方向的LinearLayout是最常用的，因为滚动内容一般是垂直排列；如果需要更复杂的布局逻辑，也可以使用RelativeLayout或ConstraintLayout，只要保证ScrollView只直接持有这一个容器就行。

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