写RecyclerView不是背代码是理解它的设计逻辑。这篇指南我会带你从环境准备一直写到常见坑的排查每一步都讲清楚“为什么这么写”最后你不仅能跑通demo还能在真实项目里灵活改。先说一下这篇内容适合谁刚学完Android基础、正准备写第一个列表页的初学者或者写过几次RecyclerView但总觉得理解不透、只会抄代码的朋友。如果你已经能熟练封装Adapter、处理多类型item和差量刷新那这篇对你来说可能偏基础但排查思路部分依然可以参考。1. 先搞清楚RecyclerView到底解决了什么问题1.1 从ListView到RecyclerView为什么非换不可很多新手第一次接触RecyclerView的时候都会有个疑问我不是已经会ListView了吗为什么还要学这个新的这个问题问得很好。在RecyclerView出现之前ListView是Android列表开发的绝对主力但它的几个老毛病一直很让人头疼view没有强制复用机制、需要自己写ViewHolder来优化性能、不支持横向滚动、动画支持几乎为零。你写一个简单的列表Demo可能感觉不到区别但一旦item数量上百、item布局变复杂、还要加上删除动画ListView那套写法会让你怀疑人生。RecyclerView的出现就是来解决这些问题的。它把“列表怎么展示”这件事拆成了几个独立的角色各干各的活互不干扰。你不需要再去手动处理view复用不需要自己写ViewHolder的缓存逻辑切换横竖布局只需要改一行代码增删item的动画是内置的。说白了Google把列表开发里最繁琐、最容易出错的部分帮你封装好了你要做的只是告诉它“每条数据长什么样”。我自己在实际项目里的感受是用了RecyclerView之后再回去写ListView简直像开惯了自动挡回去开手动挡浑身不自在。1.2 RecyclerView的四个核心角色怎么看懂理解RecyclerView最好的方式是把它想象成一个流水线工厂。工厂里有一条传送带传送带本身只负责把item滚来滚去这就是RecyclerView本体。传送带上站的每个工位负责把一块原材料组装成一个半成品这就是ViewHolder它缓存了你item布局里所有控件的引用省去反复findViewById的开销。工厂的调度员根据订单数量决定要多少个工位、给每个工位安排什么原材料这就是Adapter。传送带的铺设方式横着铺还是竖着铺是网格铺还是瀑布流铺这就是LayoutManager。这四个角色各有各的职责互不越界。很多新手写代码的时候容易把一堆逻辑全塞进Adapter里结果Adapter变得又臭又长改一个需求要动半天。记住一个原则Adapter只负责“数据和view的绑定”业务逻辑应该放到Activity/Fragment或者其他管理类里。1.3 性能与缓存机制搞清楚这个才算入门RecyclerView最核心的卖点其实是它的缓存机制这块搞不懂后面优化列表性能就是瞎蒙。当item滑出屏幕RecyclerView并不会直接销毁它。它会把item对应的ViewHolder放进缓存池里等新的item滑入屏幕时直接从缓存池里拿出来复用只需要重新绑定数据就行。这里的关键在于创建ViewHolderonCreateViewHolder和绑定数据onBindViewHolder是两件独立的事。onCreateViewHolder只在缓存池为空时才会被调用而onBindViewHolder则会随数据变化反复调用。我见过不少新手在onBindViewHolder里做耗时操作比如频繁创建新对象、做IO读文件结果列表一滑动就卡成PPT。你应该把能复用的对象提前准备好在onBindViewHolder里只做轻量级的数据绑定别在这里搞任何重活。这一点你自己写代码的时候一定要刻在脑子里。2. 环境准备装好工具再动手2.1 Android Studio安装与中文界面设置工欲善其事必先利其器。写RecyclerView之前先把开发环境搞定。目前主流的开发工具仍然是Android Studio官方IDE直接从官网下载对应你操作系统的安装包就行。Windows用户下载exe安装包macOS用户下载dmg一路下一步就能装好。安装过程没什么难度唯一要注意的就是安装路径别带中文和空格有些老项目对路径敏感以后编译出问题排查起来很费劲。装好之后很多新手会问Android Studio能不能设置成中文答案是官方本身没有中文语言包但你可以通过安装Chinese Language Pack插件实现界面汉化。操作路径是File - Settings - Plugins在Marketplace里搜索“Chinese”找到Chinese Language Pack这个插件安装重启IDE后就变成中文界面了。这个插件对纯新手确实友好很多查找菜单、配置项都一眼能看懂但等用熟之后我建议还是换回英文界面毕竟网上的技术文档和报错信息都是英文提前适应没坏处。2.2 创建项目与引入RecyclerView依赖启动Android Studio之后选择New Project模板选Empty Views Activity项目名和包名按你自己的需求填比如项目名可以叫RecyclerViewDemo包名用你自己的域名反写。语言建议Kotlin目前Google对Kotlin的支持已经是第一优先级新项目直接用Kotlin不会错。需要说明的是在新的Android Studio版本里如果创建的是Empty Views Activity项目里不会自动带RecyclerView依赖你需要手动在app模块的build.gradle文件里添加上依赖。如果你用的是Groovy DSL在dependencies代码块里加implementation androidx.recyclerview:recyclerview:1.3.2如果你用的是Kotlin DSLbuild.gradle.kts则这样写implementation(androidx.recyclerview:recyclerview:1.3.2)添加完依赖之后点一下Sync Now等待Gradle同步完成就OK了。版本号可以选当前最新稳定版1.3.2是截至目前比较稳定的一个版本。以后版本更新去Google官方文档页面查一下就行。这里帮你梳理一下环境准备阶段的完整清单安装JDK 17或更高版本Android Studio自带一般不用手动装安装Android Studio最新稳定版安装Android SDK Platform安装向导会自动处理创建一个Empty Views Activity项目在build.gradle里添加RecyclerView依赖在模拟器或真机上跑通一个HelloWorld3. 核心细节解析手写一个RecyclerView的完整流程3.1 先在布局文件里声明RecyclerView环境准备好之后我们直接开写。第一步很简单在你的Activity布局文件里放一个RecyclerView。?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical androidx.recyclerview.widget.RecyclerView android:idid/recyclerView android:layout_widthmatch_parent android:layout_heightmatch_parent / /LinearLayout这里有两个属性要留意一下宽高都用match_parent让列表填满整个屏幕。至于RecyclerView的滚动效果、裁剪方式等属性可以在后续需要的时候再调新手阶段先不纠结。需要注意的是RecyclerView在布局文件里的标签名要写全androidx.recyclerview.widget.RecyclerView。有些老教程写的是android.support.v7.widget.RecyclerView那是旧版support库的写法现在已经废弃了你照着写会直接报找不到类。3.2 创建item布局决定列表里每一行长什么样item布局是列表列表“长相”的基础。假设我们要做一个新闻列表每条item显示一个标题和一段摘要那就新建一个布局文件名字叫item_news.xml。?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationvertical android:padding16dp TextView android:idid/tvTitle android:layout_widthmatch_parent android:layout_heightwrap_content android:textSize18sp android:textStylebold android:textColor#333333 / TextView android:idid/tvContent android:layout_widthmatch_parent android:layout_heightwrap_content android:layout_marginTop8dp android:textSize14sp android:textColor#666666 / /LinearLayout这里有个细节根布局的宽高宽度是match_parent高度是wrap_content。宽度撑满父容器是RecyclerView列表item的通用做法高度则根据内容自动撑开。你不需要在item布局里设置RecyclerView的触摸反馈相关属性那些是ListView时代才需要处理的事。item布局写完之后最好先在布局预览里看一眼效果确认控件位置和字体大小是否符合预期再继续往下写代码。改布局比改代码便宜预览能帮你在最早阶段发现问题。3.3 写Adapter这是RecyclerView的灵魂Adapter是整个RecyclerView里代码量最大、你平时最常写的类。新手容易把Adapter当成一个死记硬背的模板但你要理解每个方法是在什么时机被调用的。我们先定义一个数据实体类NewsBeandata class NewsBean( val title: String, val content: String )然后写核心的Adapter类继承RecyclerView.Adapter泛型传我们自己的ViewHolderclass NewsAdapter(private val dataList: ListNewsBean) : RecyclerView.AdapterNewsAdapter.NewsViewHolder() { class NewsViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) { val tvTitle: TextView itemView.findViewById(R.id.tvTitle) val tvContent: TextView itemView.findViewById(R.id.tvContent) } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): NewsViewHolder { val view LayoutInflater.from(parent.context) .inflate(R.layout.item_news, parent, false) return NewsViewHolder(view) } override fun onBindViewHolder(holder: NewsViewHolder, position: Int) { val bean dataList[position] holder.tvTitle.text bean.title holder.tvContent.text bean.content } override fun getItemCount(): Int dataList.size }这里有几个关键点一定要理解onCreateViewHolder只负责创建ViewHolder对象也就是把item布局文件解析成view并且包装成ViewHolder这通常只在缓存池为空时需要新建item时才会调用。onBindViewHolder负责把第position条数据绑定到holder对应的控件上每滑入一条新的item都会执行一次。getItemCount告诉RecyclerView数据总共有多少条它决定了列表的长度。一个常见的疑问是onCreateViewHolder里的parent参数有什么用它的类型是ViewGroup就是RecyclerView本身。inflate的时候需要把parent作为父容器传进去第三个参数传false表示不立即添加到parent上RecyclerView会在合适的时机自己把它添加进去。如果第三个参数你写成了true代码也不会即刻崩溃但会导致item布局被重复添加或层级污染出现一些诡异的显示问题所以这里老老实实传false。3.4 在Activity中串联整个链路Adapter写完了下一步就是在Activity里“组装”整个RecyclerView。这个组装过程只有三步创建数据、设置布局管理器、给Adapter设置数据并绑定。在MainActivity的onCreate中写class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val recyclerView findViewByIdRecyclerView(R.id.recyclerView) // 1. 准备数据 val dataList mutableListOfNewsBean() for (i in 1..50) { dataList.add(NewsBean(新闻标题 $i, 这是第 $i 条新闻的摘要内容)) } // 2. 设置布局管理器 recyclerView.layoutManager LinearLayoutManager(this) // 3. 创建Adapter并设置 val adapter NewsAdapter(dataList) recyclerView.adapter adapter } }看到这里你已经能跑通一个最基本的RecyclerView了。三步缺一不可没有数据列表列表是空的没有LayoutManager列表直接闪退没有设置adapter界面会白屏。关于LinearLayoutManager需要多说一句。new LinearLayoutManager(this)默认是纵向列表如果你想做横向滑动可以在构造时传第二个参数比如LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)第三个参数false表示不反转布局方向。如果你想做GridView那种网格效果用GridLayoutManager(context, spanCount)就行比如GridLayoutManager(this, 2)就是两列网格。瀑布流要用StaggeredGridLayoutManager。这一套组合拳打下来同一个Adapter不需要改任何代码就能让同一个数据列表在纵向、横向、网格、瀑布流四种形态之间自由切换这就是RecyclerView设计得巧妙的地方。4. 实操过程让列表真正“活”起来4.1 点击事件怎么加才合理新手写RecyclerView点击事件最常见的做法是在onBindViewHolder里给控件设置setOnClickListener然后在监听器里根据position处理逻辑。这个方法能用但不够优雅尤其当你在多个页面复用同一个Adapter时点击逻辑写死在Adapter里Activity那边很难做不同处理。我推荐用接口回调的方式。先在Adapter里定义一个接口class NewsAdapter( private val dataList: ListNewsBean, private val onItemClick: ((NewsBean, Int) - Unit)? null ) : RecyclerView.AdapterNewsAdapter.NewsViewHolder() { // ... override fun onBindViewHolder(holder: NewsViewHolder, position: Int) { val bean dataList[position] holder.tvTitle.text bean.title holder.tvContent.text bean.content holder.itemView.setOnClickListener { onItemClick?.invoke(bean, position) } } }这样在Activity里你只需要这样写val adapter NewsAdapter(dataList) { bean, position - Toast.makeText(this, 点击了 ${bean.title}, Toast.LENGTH_SHORT).show() }好处是Adapter完全不用关心点击之后要做什么只管布局和绑定业务逻辑交给了调用方。如果你在多个页面复用它每个页面可以传不同的回调各做各的事代码清晰很多。这里有个细节回调里的position不一定和当前数据索引一致。如果你在列表中做了删除操作并且用的是notifyItemRemoved这个position在动画执行期间可能对应的不是重新布局后的真实位置。为了避免这种坑我一般不用position去数据源里取值而是直接回调Bean对象这样无论列表怎么增删拿到的数据都一定是准确的。这个经验是我踩过几次坑之后总结出来的新手建议直接照着做。4.2 数据增删后刷新别只会notifyDataSetChanged列表做出来之后下一步就是要支持数据的增删改比如下拉刷新、加载更多、删除某一条。新手最粗暴的做法是数据变了之后调用adapter.notifyDataSetChanged()。这个方法虽然能让列表刷新但它是无脑全量刷新所有可见item都会重新执行onBindViewHolder不仅浪费性能而且会丢失item现有的状态比如图片的过渡动画、item的选中状态在数据量大或item复杂的时候还会造成闪烁。正确的做法是使用差量刷新的相关方法添加一条数据notifyItemInserted(position)删除一条数据notifyItemRemoved(position)修改某一条数据notifyItemChanged(position)移动某一条数据notifyItemMoved(fromPosition, toPosition)举个例子如果我要删除列表中的第三条数据if (position in dataList.indices) { dataList.removeAt(position) adapter.notifyItemRemoved(position) }这样写RecyclerView会执行删除动画相邻item平滑上移视觉效果非常自然。你可能会问如果一次删了好几条怎么办那就要用一个支持批量操作的机制比如DiffUtil。DiffUtil可以在两个数据集之间计算出最小差异然后自动调用notifyItemRangeInserted、notifyItemRangeRemoved、notifyItemChanged等一组方法让列表以最精准的方式刷新。这个类你暂时不用完全啃透但至少要知道有这个东西以后做大列表、频繁增删的时候你会回来感谢它的。4.3 多类型item怎么做一个Adapter顶三个真实项目里一个列表里往往不只有一种item。比如一个商城首页顶部是轮播图中间是分类入口再往下是商品列表这些都是不同样式的item在同一个RecyclerView里展示。这就要用到Adapter的多类型支持。核心方法是重写getItemViewType让不同类型的item返回不同的int值。然后在onCreateViewHolder里根据viewType创建不同的ViewHolder在onBindViewHolder里根据holder的类型绑定不同的数据。我给一个简化的思路class MultiTypeAdapter( private val items: ListAny ) : RecyclerView.AdapterRecyclerView.ViewHolder() { companion object { private const val TYPE_BANNER 0 private const val TYPE_NORMAL 1 } override fun getItemViewType(position: Int): Int { return when (items[position]) { is BannerBean - TYPE_BANNER else - TYPE_NORMAL } } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder { return when (viewType) { TYPE_BANNER - BannerViewHolder(...) else - NormalViewHolder(...) } } override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) { when (holder) { is BannerViewHolder - holder.bind(items[position] as BannerBean) is NormalViewHolder - holder.bind(items[position] as NewsBean) } } override fun getItemCount(): Int items.size }这种多类型Adapter写起来确实比单类型多几行代码但逻辑清晰类型之间互相不干扰。如果你以后再接触第三方库或者阅读开源项目源码会经常看到这种写法所以建议你亲手写一遍。等你熟练了还可以用密封类sealed class来定义item类型让类型安全更进一步不过那是另一个话题了。5. 常见问题与排查技巧实录5.1 列表空白不显示数据怎么回事很多新手第一次写完RecyclerView兴冲冲一运行结果界面上什么都没有整个人都懵了。这种情况九成是以下几个原因第一没有设置LayoutManager。RecyclerView和ListView不一样它必须有一个LayoutManager来负责布局缺了它不会自动纵向排列。检查一下有没有执行recyclerView.layoutManager LinearLayoutManager(this)。第二数据源是空的。检查dataList里有没有数据getItemCount返回的是不是0。可以在Adapter里加一行Log打印或者打断点看dataList.size。第三item布局高度问题。如果item布局根节点的高度是match_parent每一行都会占满一整个屏幕只看得到第一条后面的item要滑动才会看到。记得把根节点高度改成wrap_content。第四Adapter没有设置给RecyclerView。如果只创建了Adapter对象但忘了赋值给recyclerView.adapter界面就是空白。这四类问题按顺序排查绝大多数空白问题都能解决。5.2 滑动卡顿性能怎么优化列表滑动卡顿是另一个高频问题。如果你用低端机测试一滑一卡需要按顺序排查以下几个方面。在onBindViewHolder里不要做耗时操作。不要在这里执行网络请求、文件IO、图片加载、JSON解析。图片加载要用专门的库比如Glide或Coil让它在后台线程处理然后用回调更新ImageView。不要在onBindViewHolder里创建大量新对象不要在每次绑定时inflate新的View那些应该放到onCreateViewHolder里去。避免item布局层级过深。布局嵌套层次越多测量和绘制时间越长每一条item多浪费几毫秒几十条item积累下来就能感觉出来了。能用LinearLayout解决的就别用RelativeLayout嵌套能用ConstraintLayout替代多层嵌套就尽量替代。复用资源。比如文本颜色、Drawable对象、Spannable等尽量在Adapter里一次性创建好不要每次绑定都重新new。这一套做下来列表性能基本就有保证了。5.3 数据更新后界面不刷新为什么有时候你会发现在子线程里改了数据然后调用notifyDataSetChanged()界面居然没有任何变化。这通常不是RecyclerView的问题而是Android的线程机制问题。RecyclerView的adapter方法只允许在主线程调用。如果你在子线程里改了数据或者IllegalStateException报错提示“Cannot call this method while RecyclerView is computing a layout”那就是线程用错了。解决方案很简单子线程跑完任务之后通过runOnUiThread或者View.post切回主线程再更新数据、刷新列表。还有一个不太容易发现的问题是数据对象没变。如果你的dataList里的对象是用val声明的然后你直接修改了对象的某个字段比如bean.title 新标题却调用了notifyDataSetChanged列表不会刷新因为Adapter持有的List引用没有变它以为没有数据变化。这种情况下你需要复制一份新的List传给Adapter或者用notifyItemChanged来强制刷新某一条。5.4 新手常踩的坑一次帮你排完我整理了一份高频坑位对照表都是我在带新人和自己写代码时遇到过的问题直接对照检查就行。现象原因解决方案运行崩溃RecyclerView: No adapter attached没有给RecyclerView设置adapter检查是否执行了setAdapter运行崩溃ClassCastException多类型item时数据转换错误检查getItemViewType和强转类型是否匹配item显示不全或重叠item布局高度设置错误根布局高度改为wrap_content添加数据后界面没变化没有调用notifyItemInserted调用adapter.notifyItemInserted(position)删除数据后index越界先notify后改数据或改数据后没notify先改数据源再notifyItemRemoved(position)列表出现闪烁或图片跳动用了notifyDataSetChanged全局刷新改成精准的notifyItemChanged等方法点击事件拿到的position不对回调里直接用了旧position回调Bean对象而非索引item复用后状态错乱比如CheckBox选中状态没有重置在onBindViewHolder中对状态进行重置或重新设置写在最后RecyclerView这块内容我见过太多人卡在“能跑起来但改不动”的阶段根本原因就是只记API不记原理。这篇指南把每个关键步骤和它背后的设计逻辑都讲了一遍至少能帮你建立好正确的认知框架。我个人写RecyclerView几年下来的经验是不要怕写Adapter多写几次你自然就熟了遇到问题先看Logcat再回头检查数据和视图的绑定关系想进阶就去看官方源码RecyclerView内部的设计远比你想的精妙。下一篇我准备写一写DiffUtil和ListAdapter的实战用法如果你正在为“如何优雅地刷新列表”发愁那会是篇对你有用的内容。
写RecyclerView不是背代码是理解它的设计逻辑。这篇指南我会带你从环境准备一直写到常见坑的排查每一步都讲清楚“为什么这么写”最后你不仅能跑通demo还能在真实项目里灵活改。先说一下这篇内容适合谁刚学完Android基础、正准备写第一个列表页的初学者或者写过几次RecyclerView但总觉得理解不透、只会抄代码的朋友。如果你已经能熟练封装Adapter、处理多类型item和差量刷新那这篇对你来说可能偏基础但排查思路部分依然可以参考。1. 先搞清楚RecyclerView到底解决了什么问题1.1 从ListView到RecyclerView为什么非换不可很多新手第一次接触RecyclerView的时候都会有个疑问我不是已经会ListView了吗为什么还要学这个新的这个问题问得很好。在RecyclerView出现之前ListView是Android列表开发的绝对主力但它的几个老毛病一直很让人头疼view没有强制复用机制、需要自己写ViewHolder来优化性能、不支持横向滚动、动画支持几乎为零。你写一个简单的列表Demo可能感觉不到区别但一旦item数量上百、item布局变复杂、还要加上删除动画ListView那套写法会让你怀疑人生。RecyclerView的出现就是来解决这些问题的。它把“列表怎么展示”这件事拆成了几个独立的角色各干各的活互不干扰。你不需要再去手动处理view复用不需要自己写ViewHolder的缓存逻辑切换横竖布局只需要改一行代码增删item的动画是内置的。说白了Google把列表开发里最繁琐、最容易出错的部分帮你封装好了你要做的只是告诉它“每条数据长什么样”。我自己在实际项目里的感受是用了RecyclerView之后再回去写ListView简直像开惯了自动挡回去开手动挡浑身不自在。1.2 RecyclerView的四个核心角色怎么看懂理解RecyclerView最好的方式是把它想象成一个流水线工厂。工厂里有一条传送带传送带本身只负责把item滚来滚去这就是RecyclerView本体。传送带上站的每个工位负责把一块原材料组装成一个半成品这就是ViewHolder它缓存了你item布局里所有控件的引用省去反复findViewById的开销。工厂的调度员根据订单数量决定要多少个工位、给每个工位安排什么原材料这就是Adapter。传送带的铺设方式横着铺还是竖着铺是网格铺还是瀑布流铺这就是LayoutManager。这四个角色各有各的职责互不越界。很多新手写代码的时候容易把一堆逻辑全塞进Adapter里结果Adapter变得又臭又长改一个需求要动半天。记住一个原则Adapter只负责“数据和view的绑定”业务逻辑应该放到Activity/Fragment或者其他管理类里。1.3 性能与缓存机制搞清楚这个才算入门RecyclerView最核心的卖点其实是它的缓存机制这块搞不懂后面优化列表性能就是瞎蒙。当item滑出屏幕RecyclerView并不会直接销毁它。它会把item对应的ViewHolder放进缓存池里等新的item滑入屏幕时直接从缓存池里拿出来复用只需要重新绑定数据就行。这里的关键在于创建ViewHolderonCreateViewHolder和绑定数据onBindViewHolder是两件独立的事。onCreateViewHolder只在缓存池为空时才会被调用而onBindViewHolder则会随数据变化反复调用。我见过不少新手在onBindViewHolder里做耗时操作比如频繁创建新对象、做IO读文件结果列表一滑动就卡成PPT。你应该把能复用的对象提前准备好在onBindViewHolder里只做轻量级的数据绑定别在这里搞任何重活。这一点你自己写代码的时候一定要刻在脑子里。2. 环境准备装好工具再动手2.1 Android Studio安装与中文界面设置工欲善其事必先利其器。写RecyclerView之前先把开发环境搞定。目前主流的开发工具仍然是Android Studio官方IDE直接从官网下载对应你操作系统的安装包就行。Windows用户下载exe安装包macOS用户下载dmg一路下一步就能装好。安装过程没什么难度唯一要注意的就是安装路径别带中文和空格有些老项目对路径敏感以后编译出问题排查起来很费劲。装好之后很多新手会问Android Studio能不能设置成中文答案是官方本身没有中文语言包但你可以通过安装Chinese Language Pack插件实现界面汉化。操作路径是File - Settings - Plugins在Marketplace里搜索“Chinese”找到Chinese Language Pack这个插件安装重启IDE后就变成中文界面了。这个插件对纯新手确实友好很多查找菜单、配置项都一眼能看懂但等用熟之后我建议还是换回英文界面毕竟网上的技术文档和报错信息都是英文提前适应没坏处。2.2 创建项目与引入RecyclerView依赖启动Android Studio之后选择New Project模板选Empty Views Activity项目名和包名按你自己的需求填比如项目名可以叫RecyclerViewDemo包名用你自己的域名反写。语言建议Kotlin目前Google对Kotlin的支持已经是第一优先级新项目直接用Kotlin不会错。需要说明的是在新的Android Studio版本里如果创建的是Empty Views Activity项目里不会自动带RecyclerView依赖你需要手动在app模块的build.gradle文件里添加上依赖。如果你用的是Groovy DSL在dependencies代码块里加implementation androidx.recyclerview:recyclerview:1.3.2如果你用的是Kotlin DSLbuild.gradle.kts则这样写implementation(androidx.recyclerview:recyclerview:1.3.2)添加完依赖之后点一下Sync Now等待Gradle同步完成就OK了。版本号可以选当前最新稳定版1.3.2是截至目前比较稳定的一个版本。以后版本更新去Google官方文档页面查一下就行。这里帮你梳理一下环境准备阶段的完整清单安装JDK 17或更高版本Android Studio自带一般不用手动装安装Android Studio最新稳定版安装Android SDK Platform安装向导会自动处理创建一个Empty Views Activity项目在build.gradle里添加RecyclerView依赖在模拟器或真机上跑通一个HelloWorld3. 核心细节解析手写一个RecyclerView的完整流程3.1 先在布局文件里声明RecyclerView环境准备好之后我们直接开写。第一步很简单在你的Activity布局文件里放一个RecyclerView。?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightmatch_parent android:orientationvertical androidx.recyclerview.widget.RecyclerView android:idid/recyclerView android:layout_widthmatch_parent android:layout_heightmatch_parent / /LinearLayout这里有两个属性要留意一下宽高都用match_parent让列表填满整个屏幕。至于RecyclerView的滚动效果、裁剪方式等属性可以在后续需要的时候再调新手阶段先不纠结。需要注意的是RecyclerView在布局文件里的标签名要写全androidx.recyclerview.widget.RecyclerView。有些老教程写的是android.support.v7.widget.RecyclerView那是旧版support库的写法现在已经废弃了你照着写会直接报找不到类。3.2 创建item布局决定列表里每一行长什么样item布局是列表列表“长相”的基础。假设我们要做一个新闻列表每条item显示一个标题和一段摘要那就新建一个布局文件名字叫item_news.xml。?xml version1.0 encodingutf-8? LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationvertical android:padding16dp TextView android:idid/tvTitle android:layout_widthmatch_parent android:layout_heightwrap_content android:textSize18sp android:textStylebold android:textColor#333333 / TextView android:idid/tvContent android:layout_widthmatch_parent android:layout_heightwrap_content android:layout_marginTop8dp android:textSize14sp android:textColor#666666 / /LinearLayout这里有个细节根布局的宽高宽度是match_parent高度是wrap_content。宽度撑满父容器是RecyclerView列表item的通用做法高度则根据内容自动撑开。你不需要在item布局里设置RecyclerView的触摸反馈相关属性那些是ListView时代才需要处理的事。item布局写完之后最好先在布局预览里看一眼效果确认控件位置和字体大小是否符合预期再继续往下写代码。改布局比改代码便宜预览能帮你在最早阶段发现问题。3.3 写Adapter这是RecyclerView的灵魂Adapter是整个RecyclerView里代码量最大、你平时最常写的类。新手容易把Adapter当成一个死记硬背的模板但你要理解每个方法是在什么时机被调用的。我们先定义一个数据实体类NewsBeandata class NewsBean( val title: String, val content: String )然后写核心的Adapter类继承RecyclerView.Adapter泛型传我们自己的ViewHolderclass NewsAdapter(private val dataList: ListNewsBean) : RecyclerView.AdapterNewsAdapter.NewsViewHolder() { class NewsViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) { val tvTitle: TextView itemView.findViewById(R.id.tvTitle) val tvContent: TextView itemView.findViewById(R.id.tvContent) } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): NewsViewHolder { val view LayoutInflater.from(parent.context) .inflate(R.layout.item_news, parent, false) return NewsViewHolder(view) } override fun onBindViewHolder(holder: NewsViewHolder, position: Int) { val bean dataList[position] holder.tvTitle.text bean.title holder.tvContent.text bean.content } override fun getItemCount(): Int dataList.size }这里有几个关键点一定要理解onCreateViewHolder只负责创建ViewHolder对象也就是把item布局文件解析成view并且包装成ViewHolder这通常只在缓存池为空时需要新建item时才会调用。onBindViewHolder负责把第position条数据绑定到holder对应的控件上每滑入一条新的item都会执行一次。getItemCount告诉RecyclerView数据总共有多少条它决定了列表的长度。一个常见的疑问是onCreateViewHolder里的parent参数有什么用它的类型是ViewGroup就是RecyclerView本身。inflate的时候需要把parent作为父容器传进去第三个参数传false表示不立即添加到parent上RecyclerView会在合适的时机自己把它添加进去。如果第三个参数你写成了true代码也不会即刻崩溃但会导致item布局被重复添加或层级污染出现一些诡异的显示问题所以这里老老实实传false。3.4 在Activity中串联整个链路Adapter写完了下一步就是在Activity里“组装”整个RecyclerView。这个组装过程只有三步创建数据、设置布局管理器、给Adapter设置数据并绑定。在MainActivity的onCreate中写class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val recyclerView findViewByIdRecyclerView(R.id.recyclerView) // 1. 准备数据 val dataList mutableListOfNewsBean() for (i in 1..50) { dataList.add(NewsBean(新闻标题 $i, 这是第 $i 条新闻的摘要内容)) } // 2. 设置布局管理器 recyclerView.layoutManager LinearLayoutManager(this) // 3. 创建Adapter并设置 val adapter NewsAdapter(dataList) recyclerView.adapter adapter } }看到这里你已经能跑通一个最基本的RecyclerView了。三步缺一不可没有数据列表列表是空的没有LayoutManager列表直接闪退没有设置adapter界面会白屏。关于LinearLayoutManager需要多说一句。new LinearLayoutManager(this)默认是纵向列表如果你想做横向滑动可以在构造时传第二个参数比如LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)第三个参数false表示不反转布局方向。如果你想做GridView那种网格效果用GridLayoutManager(context, spanCount)就行比如GridLayoutManager(this, 2)就是两列网格。瀑布流要用StaggeredGridLayoutManager。这一套组合拳打下来同一个Adapter不需要改任何代码就能让同一个数据列表在纵向、横向、网格、瀑布流四种形态之间自由切换这就是RecyclerView设计得巧妙的地方。4. 实操过程让列表真正“活”起来4.1 点击事件怎么加才合理新手写RecyclerView点击事件最常见的做法是在onBindViewHolder里给控件设置setOnClickListener然后在监听器里根据position处理逻辑。这个方法能用但不够优雅尤其当你在多个页面复用同一个Adapter时点击逻辑写死在Adapter里Activity那边很难做不同处理。我推荐用接口回调的方式。先在Adapter里定义一个接口class NewsAdapter( private val dataList: ListNewsBean, private val onItemClick: ((NewsBean, Int) - Unit)? null ) : RecyclerView.AdapterNewsAdapter.NewsViewHolder() { // ... override fun onBindViewHolder(holder: NewsViewHolder, position: Int) { val bean dataList[position] holder.tvTitle.text bean.title holder.tvContent.text bean.content holder.itemView.setOnClickListener { onItemClick?.invoke(bean, position) } } }这样在Activity里你只需要这样写val adapter NewsAdapter(dataList) { bean, position - Toast.makeText(this, 点击了 ${bean.title}, Toast.LENGTH_SHORT).show() }好处是Adapter完全不用关心点击之后要做什么只管布局和绑定业务逻辑交给了调用方。如果你在多个页面复用它每个页面可以传不同的回调各做各的事代码清晰很多。这里有个细节回调里的position不一定和当前数据索引一致。如果你在列表中做了删除操作并且用的是notifyItemRemoved这个position在动画执行期间可能对应的不是重新布局后的真实位置。为了避免这种坑我一般不用position去数据源里取值而是直接回调Bean对象这样无论列表怎么增删拿到的数据都一定是准确的。这个经验是我踩过几次坑之后总结出来的新手建议直接照着做。4.2 数据增删后刷新别只会notifyDataSetChanged列表做出来之后下一步就是要支持数据的增删改比如下拉刷新、加载更多、删除某一条。新手最粗暴的做法是数据变了之后调用adapter.notifyDataSetChanged()。这个方法虽然能让列表刷新但它是无脑全量刷新所有可见item都会重新执行onBindViewHolder不仅浪费性能而且会丢失item现有的状态比如图片的过渡动画、item的选中状态在数据量大或item复杂的时候还会造成闪烁。正确的做法是使用差量刷新的相关方法添加一条数据notifyItemInserted(position)删除一条数据notifyItemRemoved(position)修改某一条数据notifyItemChanged(position)移动某一条数据notifyItemMoved(fromPosition, toPosition)举个例子如果我要删除列表中的第三条数据if (position in dataList.indices) { dataList.removeAt(position) adapter.notifyItemRemoved(position) }这样写RecyclerView会执行删除动画相邻item平滑上移视觉效果非常自然。你可能会问如果一次删了好几条怎么办那就要用一个支持批量操作的机制比如DiffUtil。DiffUtil可以在两个数据集之间计算出最小差异然后自动调用notifyItemRangeInserted、notifyItemRangeRemoved、notifyItemChanged等一组方法让列表以最精准的方式刷新。这个类你暂时不用完全啃透但至少要知道有这个东西以后做大列表、频繁增删的时候你会回来感谢它的。4.3 多类型item怎么做一个Adapter顶三个真实项目里一个列表里往往不只有一种item。比如一个商城首页顶部是轮播图中间是分类入口再往下是商品列表这些都是不同样式的item在同一个RecyclerView里展示。这就要用到Adapter的多类型支持。核心方法是重写getItemViewType让不同类型的item返回不同的int值。然后在onCreateViewHolder里根据viewType创建不同的ViewHolder在onBindViewHolder里根据holder的类型绑定不同的数据。我给一个简化的思路class MultiTypeAdapter( private val items: ListAny ) : RecyclerView.AdapterRecyclerView.ViewHolder() { companion object { private const val TYPE_BANNER 0 private const val TYPE_NORMAL 1 } override fun getItemViewType(position: Int): Int { return when (items[position]) { is BannerBean - TYPE_BANNER else - TYPE_NORMAL } } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder { return when (viewType) { TYPE_BANNER - BannerViewHolder(...) else - NormalViewHolder(...) } } override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) { when (holder) { is BannerViewHolder - holder.bind(items[position] as BannerBean) is NormalViewHolder - holder.bind(items[position] as NewsBean) } } override fun getItemCount(): Int items.size }这种多类型Adapter写起来确实比单类型多几行代码但逻辑清晰类型之间互相不干扰。如果你以后再接触第三方库或者阅读开源项目源码会经常看到这种写法所以建议你亲手写一遍。等你熟练了还可以用密封类sealed class来定义item类型让类型安全更进一步不过那是另一个话题了。5. 常见问题与排查技巧实录5.1 列表空白不显示数据怎么回事很多新手第一次写完RecyclerView兴冲冲一运行结果界面上什么都没有整个人都懵了。这种情况九成是以下几个原因第一没有设置LayoutManager。RecyclerView和ListView不一样它必须有一个LayoutManager来负责布局缺了它不会自动纵向排列。检查一下有没有执行recyclerView.layoutManager LinearLayoutManager(this)。第二数据源是空的。检查dataList里有没有数据getItemCount返回的是不是0。可以在Adapter里加一行Log打印或者打断点看dataList.size。第三item布局高度问题。如果item布局根节点的高度是match_parent每一行都会占满一整个屏幕只看得到第一条后面的item要滑动才会看到。记得把根节点高度改成wrap_content。第四Adapter没有设置给RecyclerView。如果只创建了Adapter对象但忘了赋值给recyclerView.adapter界面就是空白。这四类问题按顺序排查绝大多数空白问题都能解决。5.2 滑动卡顿性能怎么优化列表滑动卡顿是另一个高频问题。如果你用低端机测试一滑一卡需要按顺序排查以下几个方面。在onBindViewHolder里不要做耗时操作。不要在这里执行网络请求、文件IO、图片加载、JSON解析。图片加载要用专门的库比如Glide或Coil让它在后台线程处理然后用回调更新ImageView。不要在onBindViewHolder里创建大量新对象不要在每次绑定时inflate新的View那些应该放到onCreateViewHolder里去。避免item布局层级过深。布局嵌套层次越多测量和绘制时间越长每一条item多浪费几毫秒几十条item积累下来就能感觉出来了。能用LinearLayout解决的就别用RelativeLayout嵌套能用ConstraintLayout替代多层嵌套就尽量替代。复用资源。比如文本颜色、Drawable对象、Spannable等尽量在Adapter里一次性创建好不要每次绑定都重新new。这一套做下来列表性能基本就有保证了。5.3 数据更新后界面不刷新为什么有时候你会发现在子线程里改了数据然后调用notifyDataSetChanged()界面居然没有任何变化。这通常不是RecyclerView的问题而是Android的线程机制问题。RecyclerView的adapter方法只允许在主线程调用。如果你在子线程里改了数据或者IllegalStateException报错提示“Cannot call this method while RecyclerView is computing a layout”那就是线程用错了。解决方案很简单子线程跑完任务之后通过runOnUiThread或者View.post切回主线程再更新数据、刷新列表。还有一个不太容易发现的问题是数据对象没变。如果你的dataList里的对象是用val声明的然后你直接修改了对象的某个字段比如bean.title 新标题却调用了notifyDataSetChanged列表不会刷新因为Adapter持有的List引用没有变它以为没有数据变化。这种情况下你需要复制一份新的List传给Adapter或者用notifyItemChanged来强制刷新某一条。5.4 新手常踩的坑一次帮你排完我整理了一份高频坑位对照表都是我在带新人和自己写代码时遇到过的问题直接对照检查就行。现象原因解决方案运行崩溃RecyclerView: No adapter attached没有给RecyclerView设置adapter检查是否执行了setAdapter运行崩溃ClassCastException多类型item时数据转换错误检查getItemViewType和强转类型是否匹配item显示不全或重叠item布局高度设置错误根布局高度改为wrap_content添加数据后界面没变化没有调用notifyItemInserted调用adapter.notifyItemInserted(position)删除数据后index越界先notify后改数据或改数据后没notify先改数据源再notifyItemRemoved(position)列表出现闪烁或图片跳动用了notifyDataSetChanged全局刷新改成精准的notifyItemChanged等方法点击事件拿到的position不对回调里直接用了旧position回调Bean对象而非索引item复用后状态错乱比如CheckBox选中状态没有重置在onBindViewHolder中对状态进行重置或重新设置写在最后RecyclerView这块内容我见过太多人卡在“能跑起来但改不动”的阶段根本原因就是只记API不记原理。这篇指南把每个关键步骤和它背后的设计逻辑都讲了一遍至少能帮你建立好正确的认知框架。我个人写RecyclerView几年下来的经验是不要怕写Adapter多写几次你自然就熟了遇到问题先看Logcat再回头检查数据和视图的绑定关系想进阶就去看官方源码RecyclerView内部的设计远比你想的精妙。下一篇我准备写一写DiffUtil和ListAdapter的实战用法如果你正在为“如何优雅地刷新列表”发愁那会是篇对你有用的内容。
