RecyclerView中ConstraintView显示异常：仅ImageView可见，TextView不显示

这问题我之前也碰到过类似的，结合你说的User1布局（只有两个TextView）显示正常，大概率是User2布局里添加ImageView后，约束或者TextView的属性出了岔子，给你几个实用的排查方向和解决办法：

1. 先检查TextView的约束是否“跑偏”了 #

因为User1没加ImageView时一切正常，说明Adapter的数据绑定逻辑基本没问题，问题大概率出在User2的ConstraintLayout约束上：

• 看看TextView的layout_constraintXXX_toXXXOf属性是不是设错了？比如有没有把TextView约束到ImageView的外侧，导致被挤出屏幕？或者不小心让ImageView完全覆盖了TextView？
• 可以临时给TextView加个红色背景（android:background="#FF0000"），如果能看到红色块，说明TextView是存在的，只是文字看不见；如果看不到，那就是约束导致TextView没显示出来。

2. 排查TextView的文字“隐身”问题 #

有时候TextView本身在，但就是看不到文字：

• 检查文字颜色和背景色是不是撞色了？比如背景是白色，文字也设成#FFFFFF，那肯定看不见；
• 有没有误设android:visibility="gone"或者invisible？这俩属性会直接把TextView藏起来；
• 确认Adapter里有没有给TextView正确赋值？比如是不是忘了调用textView.setText(...)，或者传入的字符串是空的？

3. 检查ConstraintLayout的尺寸和层级 #

• 确认ConstraintLayout本身的宽高是不是正确？比如有没有设成wrap_content但内容超出，导致TextView被截断？
• 看看ImageView是不是占满了整个布局？比如ImageView的约束让它撑满了父布局，把TextView压在下面了，这种情况调整ImageView的约束就行，比如让它和TextView左右/上下排列。

4. 对比User1和User2的布局差异 #

把两个布局文件放在一起逐行对比，重点看：

• TextView的约束、宽高、文字属性（textSize、textColor等）和User1是不是一致？有没有在User2里不小心改了这些？
• User1里的TextView是约束到父布局的边，User2里是不是改成约束到ImageView的边了？如果是，那ImageView的位置会不会导致TextView没空间显示？

给你个示例正确布局参考 #

假设你要做横向排列的布局，正确的ConstraintLayout写法大概是这样：

<androidx.constraintlayout.widget.ConstraintLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp">

    <ImageView
        android:id="@+id/user_avatar"
        android:layout_width="48dp"
        android:layout_height="48dp"
        android:src="@drawable/ic_default_avatar"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"/>

    <TextView
        android:id="@+id/tv_username"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="张三"
        android:textSize="16sp"
        app:layout_constraintStart_toEndOf="@id/user_avatar"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="@id/user_avatar"
        android:layout_marginStart="12dp"/>

    <TextView
        android:id="@+id/tv_user_desc"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:text="热爱编程的开发者"
        android:textSize="14sp"
        android:textColor="#666666"
        app:layout_constraintStart_toStartOf="@id/tv_username"
        app:layout_constraintTop_toBottomOf="@id/tv_username"
        app:layout_constraintEnd_toEndOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

这里的关键点是：

• 两个TextView的宽度设为0dp（也就是匹配约束），这样它们会自动填充ImageView右侧到父布局边缘的空间；
• 通过layout_constraintStart_toEndOf="@id/user_avatar"让TextView在ImageView的右侧，避免重叠。

最后再核对Adapter代码 #

确认Adapter绑定User2布局时，有没有正确找到TextView的实例：
比如Kotlin代码：

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    val item = dataList[position]
    if (item is User2Item) {
        holder.itemView.tv_username.text = item.username
        holder.itemView.tv_user_desc.text = item.userDesc
        holder.itemView.user_avatar.setImageResource(item.avatarResId)
    }
}

检查有没有拼写错误（比如TextView的id是不是和布局里的一致），如果Logcat里有空指针异常，那就是没找到控件，得核对id。

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