RecyclerView未显示数据求助：动态Header列表适配仅显示占位文本

看起来你遇到了RecyclerView绑定数据的典型问题——列表能渲染出正确数量的项，但都是布局设计时的占位文本，没有加载真实的CustomHeader数据。结合你提到的ListAdapter和ViewHolder实现，我帮你梳理几个最可能的原因和对应的解决办法：

1. 检查onBindViewHolder是否正确绑定数据 #

这是最常见的问题：你可能没有在onBindViewHolder方法里把数据源的真实值赋值给ViewHolder的控件。布局里的占位文本只会在没有代码覆盖的时候显示，所以一定要在这里完成数据替换。

比如你的Adapter里应该补充这段逻辑：

override fun onBindViewHolder(holder: HeaderViewHolder, position: Int) {
    // 获取当前位置的Header数据
    val currentHeader = headers[position]
    // 把数据赋值给对应的控件（替换占位文本）
    holder.headerTitleTextView.text = currentHeader.title
    holder.headerDescTextView.text = currentHeader.description
    // 如果有其他控件（比如图标），也要对应设置
}

2. 确认ViewHolder正确关联布局控件 #

检查你的HeaderViewHolder是否正确通过itemView.findViewById找到了布局里的控件，有没有出现ID拼写错误或者控件类型不匹配的情况。如果控件引用为null，赋值操作会静默失败，占位文本自然不会被替换。

正确的ViewHolder示例：

class HeaderViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
    // 确保这里的R.id.xxx和你布局xml里的控件ID完全一致
    val headerTitleTextView: TextView = itemView.findViewById(R.id.tv_header_title)
    val headerDescTextView: TextView = itemView.findViewById(R.id.tv_header_desc)
}

3. 验证数据源headers的有效性 #

确认传入Adapter的headers列表不是空的，并且列表中每个CustomHeader对象的属性（比如title、description）确实有真实值，而不是空字符串或者默认值。你可以在onBindViewHolder里加日志打印，排查数据是否正确：

override fun onBindViewHolder(holder: HeaderViewHolder, position: Int) {
    val currentHeader = headers[position]
    Log.d("HeaderAdapter", "Position $position: Title = ${currentHeader.title}")
    // 后续赋值逻辑...
}

4. 如果你用的是ListAdapter，别忘了用submitList更新数据 #

ListAdapter和普通的RecyclerView.Adapter不同，它依赖submitList方法来触发DiffUtil计算并更新列表。如果你只是在构造函数里传入数据源，而没有调用submitList，可能不会触发数据绑定。

调整Adapter的实现（推荐写法）：

class HeaderListAdapter(val context: Context) : ListAdapter<CustomHeader, HeaderViewHolder>(DiffCallback()) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): HeaderViewHolder {
        val view = LayoutInflater.from(context).inflate(R.layout.item_header, parent, false)
        return HeaderViewHolder(view)
    }

    override fun onBindViewHolder(holder: HeaderViewHolder, position: Int) {
        val header = getItem(position) // ListAdapter用getItem获取当前项
        holder.headerTitleTextView.text = header.title
        holder.headerDescTextView.text = header.description
    }

    // 必须实现DiffCallback来对比数据
    companion object {
        class DiffCallback : DiffUtil.ItemCallback<CustomHeader>() {
            override fun areItemsTheSame(oldItem: CustomHeader, newItem: CustomHeader): Boolean {
                // 用你的CustomHeader的唯一标识判断（比如id）
                return oldItem.id == newItem.id
            }

            override fun areContentsTheSame(oldItem: CustomHeader, newItem: CustomHeader): Boolean {
                // 对比所有需要显示的属性，判断内容是否变化
                return oldItem.title == newItem.title && oldItem.description == newItem.description
            }
        }
    }
}

然后在Activity/Fragment里提交数据：

val adapter = HeaderListAdapter(this)
recyclerView.adapter = adapter
recyclerView.layoutManager = LinearLayoutManager(this)
// 提交数据源触发更新
adapter.submitList(yourHeaderList)

5. 确认RecyclerView的基础配置正确 #

最后检查一下RecyclerView是否设置了LayoutManager——没有LayoutManager的话，RecyclerView无法确定列表的排列方式，即使Adapter正确也不会显示内容。同时确保Adapter实例已经正确设置给RecyclerView。

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