RecyclerView从零到实战：核心概念、复用机制与避坑指南

说实话RecyclerView这个控件被很多新人当成“Android开发第一道坎”真不冤。它是列表、瀑布流、卡片流一切都绕不开的核心组件但网上资料要么是太老的ListView写法要么一上来就甩一堆架构术语把人都看懵了。我写这篇的出发点很朴素从“到底为什么要用RecyclerView”开始讲一步一步把Adapter、LayoutManager、ViewHolder这些概念拆开再带你写一个能跑的列表最后把新人几乎必踩的几个坑提前放到你面前。适合刚学会Activity和布局、正准备做第一个带列表的App的开发者看也适合写了一些页面但一直没搞懂复用机制的人扫一眼。1. 写之前先想明白RecyclerView到底要解决什么问题很多教程上来就让你写三个类、四个方法结果你照着敲完运行起来是能显示了但脑子里还是一团浆糊。我建议先别急着写代码把问题本身想清楚。1.1 你以前是怎么显示一长串列表的最早我们显示列表最笨的办法是ScrollView里放一个垂直的LinearLayout然后循环加TextView进去。这个方法不是不能用问题在于假如你有1000条数据ScrollView会把1000个View全部创建出来哪怕屏幕只显示十几条每条数据如果还带一张网络图片内存直接就炸了。这也是为什么这种方式只适合几十个条目的简单页面数据一多就只能卡着等。后来ListView出现了它在滑动的过程中会回收移出屏幕的View然后复用给新出现的item内存压力一下就小了很多。但ListView有个老大难问题它把“一个item长什么样”写死成了“View 适配器返回的View”你想做多类型item、想做瀑布流都得靠各种奇技淫巧去改维护起来特别痛苦。1.2 RecyclerView到底是怎么设计出来的RecyclerView这名字拆开看就是“回收”加“视图”它把ListView那套“复用”的思想做得更极致同时把整个列表拆成了几个互相独立的部分布局排列交给LayoutManager数据绑定交给Adapter分割线、间距交给ItemDecoration增删动画交给ItemAnimator。每一块只干一件事你只需要按需替换而不是像以前那样在一个Adapter里塞一堆判断条件。我常打一个比方RecyclerView像一个食堂窗口LayoutManager是决定窗口排成一列还是两列的“桌椅摆放员”Adapter是“做饭阿姨”她只管根据菜单把菜端到窗口ItemDecoration负责把餐盘之间的挡板擦干净ItemAnimator则在你加菜、撤菜的时候搞点过渡动画。分工清楚了出了问题也知道该找谁。2. 真正动手写之前先把这三件事揉碎了代码可以照抄但概念不搞明白后面写复杂需求一定会被坑哭。这里我把新人最容易混的三块内容单独拎出来讲透。2.1 Adapter数据到item的翻译官Adapter是RecyclerView和数据源之间的桥。它有四个方法你基本每次都要实现onCreateViewHolder负责创建item对应的ViewHolderonBindViewHolder负责把某一条数据填充到ViewHolder的控件上getItemCount告诉RecyclerView总共有多少条数据还有一个getItemViewType等做多类型item时你会用到现在可以先不管。先说ViewHolder。它其实就是把item布局里的控件缓存下来避免每次绑定数据都去findViewById。你想想列表滑动一帧可能要绑定好几个item如果每个item都去遍历一次View树找控件性能就废了。所以ViewHolder的构造函数里一次性把TextView、ImageView这些控件取出来后面直接用就行。这不是可选优化而是必须的习惯。我见过不少人写Adapter时偷懒直接在onBindViewHolder里重新找控件这样列表小的时候好像没事数据一多就会感到滑动明显变卡。记住一句话onBindViewHolder里只做数据绑定不要做控件查找更不要做耗时逻辑。2.2 LayoutManager决定item怎么摆放Adapter只管“往item里填数据”至于item是竖着排、横着排、还是像瀑布流那样错落有致那是LayoutManager的事。系统提供了三个最常用的LinearLayoutManager一列或一行支持竖向列表和横向列表。构造时传LinearLayoutManager(this, RecyclerView.VERTICAL, false)第一个参数是上下文第二个是方向第三个是否倒序排列这个倒序参数用过的人都知道有多坑后面表里会讲。GridLayoutManager网格布局类似宫格。传入GridLayoutManager(this, 3)就是每行3列。它还可以通过setSpanSizeLookup让某个item单独占满一行做“头图列表”混合布局很强。StaggeredGridLayoutManager瀑布流每个item高度可以不一样适合图片类App。它有一些注意点比如item复用后高度错乱这个后面也会提到。2.3 复用机制为什么它滑起来能这么快不少人以为“复用”就是滑出屏幕的View直接拿给新item用其实RecyclerView内部是分层的。它有一套临时缓存区叫scrap和cacheView滑出的item会先短暂缓存起来如果新的item正好是同一个viewType直接拿缓存里的用不用重新创建如果缓存不够用了才进入RecycledViewPool再不够才走onCreateViewHolder创建新View。所以理论上屏幕一共能显示20个item那你滑动2000条数据时可能总共只创建了25个左右的View。这也是为什么你敢把几千上万条数据交给RecyclerView。但反过来看如果你的item里有大量的复杂布局、图片没压缩、或者onBindViewHolder里做网络请求复用机制也救不了你卡顿就在所难免。3. 实战从零开始写一个能跑的RecyclerView概念说完了开始动手。我用的是当前Android Studio新项目默认的Kotlin方式Java写法等你自己理解了完全能对应过来。如果你还在纠结“Android Studio怎么设置中文”这种界面问题我建议先放一放界面英文不影响写代码踏实把流程跑通更重要。3.1 先把依赖加上新版项目用Gradle的时候在build.gradleModule级别里的dependencies块加一行implementation androidx.recyclerview:recyclerview:1.3.2如果项目本身创建时没有带RecyclerView依赖不加这一行你就会看到ClassNotFoundException或者布局预览直接报错。依赖添加后点一下Sync等同步完成。注意检查Gradle仓库国内网络环境下如果下载慢可以考虑用镜像仓库但这不是本文重点先跑起来为准。3.2 布局文件里放一个RecyclerView打开res/layout/activity_main.xml在根布局里加上androidx.recyclerview.widget.RecyclerView android:idid/recyclerView android:layout_widthmatch_parent android:layout_heightmatch_parent android:clipToPaddingfalse /clipToPadding这里先设为false意思是当RecyclerView有内边距的时候滑动内容可以滑到padding区域这样你给整体列表做上下留白时不会出现白边被硬切掉的突兀感。这个属性后面做沉浸式列表时经常用现在设不设都不影响。再写一个item布局文件名建议叫item_simple.xml里面先放一个TextView用于显示文字LinearLayout xmlns:androidhttp://schemas.android.com/apk/res/android android:layout_widthmatch_parent android:layout_heightwrap_content android:orientationvertical android:padding16dp TextView android:idid/tvName android:layout_widthwrap_content android:layout_heightwrap_content android:textSize16sp / /LinearLayout3.3 写一个最基础的Adapter新建一个类比如SimpleAdapter.kt并把整个列表逻辑写上。我尽量简单但每一步都有用class SimpleAdapter( private val items: MutableListString ) : RecyclerView.AdapterSimpleAdapter.VH() { class VH(itemView: View) : RecyclerView.ViewHolder(itemView) { val tvName: TextView itemView.findViewById(R.id.tvName) } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): VH { val view LayoutInflater.from(parent.context) .inflate(R.layout.item_simple, parent, false) return VH(view) } override fun onBindViewHolder(holder: VH, position: Int) { holder.tvName.text items[position] } override fun getItemCount(): Int items.size }这里有个细节inflate方法第三个参数要传false。如果你传true就相当于在onCreateViewHolder阶段直接把view加到parent上了等RecyclerView再add一次就会报“View already has a parent”之类的崩溃。这个坑新手踩得非常多我当年也踩过。3.4 在Activity里把三样东西组装起来在MainActivity的onCreate中分别设置LayoutManager和Adapter顺序上建议先设置layoutManager再setAdapterclass MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) val recyclerView findViewByIdRecyclerView(R.id.recyclerView) val data mutableListOf(第一行, 第二行, 第三行) recyclerView.layoutManager LinearLayoutManager(this) recyclerView.adapter SimpleAdapter(data) } }到这里运行项目就能看到三行文字从上到下排列了。不要小看这一步你已经完成了RecyclerView的闭环布局、数据、适配器、布局管理器各司其职。接下来所有复杂的用法都是在这个骨架上加东西。3.5 分隔线和数据更新先学会这两个列表看着有点挤想加一条线怎么办很多人第一反应是给item加个背景或高度但正规做法是写一个RecyclerView.ItemDecoration它专门负责画间距和分割线不用改每个item。举个简单的竖向分割线例子class DividerItemDecoration(context: Context) : RecyclerView.ItemDecoration() { private val divider ContextCompat.getDrawable(context, R.drawable.divider_line) override fun onDraw(c: Canvas, parent: RecyclerView, state: RecyclerView.State) { super.onDraw(c, parent, state) val left parent.paddingLeft val right parent.width - parent.paddingRight for (i in 0 until parent.childCount) { val child parent.getChildAt(i) val params child.layoutParams as RecyclerView.LayoutParams val top child.bottom params.bottomMargin val bottom top (divider?.intrinsicHeight ?: 1) divider?.setBounds(left, top, right, bottom) divider?.draw(c) } } }drawable/divider_line是个高度1dp、颜色浅灰的形状文件。用的时候一行代码recyclerView.addItemDecoration(DividerItemDecoration(this))。是不是有点复杂但好处是通用性极强换风格只用改一个drawable不用去动每个item的底部margin。再说数据更新。如果用户在界面上点了按钮往列表里加一条数据最省事的方式是data.add(新的一行) adapter.notifyItemInserted(data.size - 1)notifyItemInserted比notifyDataSetChanged()好用得多前者有插入动画也告诉RecyclerView只是新增了一条后者会强制全部item重绘可能让整个列表闪烁数据量大了还掉帧。记住一个原则能精准通知变化就不要整表刷新。4. 新手必踩的坑我一个个给你列清楚我这些年帮人看代码几乎每次都能遇到下面这几个问题。我把每个坑的场景、原因和解决办法整理一下建议你收藏着等遇到了回来翻。4.1 item显示错乱尤其是图片、勾选状态这是RecyclerView复用机制带来的“经典”问题。假设你item里有一个ImageView在onBindViewHolder里只对某几个位置设置了图片其他位置没处理那复用到其他item时上一轮的图片可能原封不动留着。新手最容易在勾选框上翻车勾了第一行往下滑再滑回来发现第五行也被勾上了。原因很简单ViewHolder被复用了但状态没有重置。所以绑定数据时要对所有可能产生状态的控件做“全量赋值”。比如用图片加载库时不满足加载条件就imageView.setImageDrawable(placeholder)勾选框就checkbox.isChecked item.isChecked。宁可多写几行也不要赌“反正这个分支不会复用”。4.2 点击事件写在哪position为什么要这样取很多刚入门的人会在onBindViewHolder里给itemView设置点击监听每绑定一次就setOnClickListener一次数据一多会产生大量监听器对象虽然影响不大但完全没必要。正确的是在ViewHolder里设置一次点击时通过bindingAdapterPosition获取当前位置class VH(itemView: View) : RecyclerView.ViewHolder(itemView) { val tvName: TextView itemView.findViewById(R.id.tvName) init { itemView.setOnClickListener { val pos bindingAdapterPosition if (pos ! RecyclerView.NO_POSITION) { // onclickListener?.onItemClick(pos) } } } }为什么用bindingAdapterPosition而不是以前常用的getAdapterPosition()因为旧方法在item动画、列表更新的过程中会返回NO_POSITION或过时位置导致点击到错误的数据这个API后来已被标记废弃。一定要判断NO_POSITION不然你在动画过程中点击拿个-1去访问数组直接崩溃。4.3 崩溃、卡顿、白屏常见问题速查表我把平时高频出现的问题放在一个表里每条都是真实场景浓缩出来的现象常见原因解决办法启动直接崩溃报Expecting adapter或空指针忘给RecyclerView设置AdapterrecyclerView.adapter赋值item宽高不生效item根布局的layout_height写了match_parent改为wrap_content或固定值滑动后数据错乱复用后未重置控件状态每个控件每次绑定都全量赋值列表闪一下才显示直接在onCreate里加载数据未占位列表页先展示骨架屏数据到位后再notify滑动非常卡item布局层级太深用ConstraintLayout压平层级瀑布流高度错乱StaggeredGridLayoutManager复用导致高度继承全局设置固定宽高比或onBind重置高度循环滚动时位置串位RecyclerView反向布局参数理解错检查LayoutManager的reverseLayout参数图片加载错乱加载库本身问题使用Glide的.override()并配合placeholder4.4 NestedScrollView里放RecyclerView劝你慎用很多新手为了实现“整个页面滚动其中一块是列表”直接把RecyclerView放进NestedScrollView里结果发现要么只能滚一点点要么卡得不行。原因是当RecyclerView嵌在另一个可滚动容器里时它会测量所有item的高度复用机制直接失效等于每个item的View全被创建出来内存和CPU双重爆炸。如果你确实需要这种页面结构我的建议顺序是先考虑用CoordinatorLayout加AppBarLayout实现一部分复杂滚动如果只是“顶部一个banner 下面列表”完全可以用RecyclerView配合多类型item实现让banner成为列表的第0个item。这个方案代码量多一点但体验最稳。4.5 网络图片自带的OOM问题如果你的item要显示网络图片一定不要直接用BitmapFactory.decodeStream去加载分分钟内存溢出。别重复造轮子上Glide或Coil。用Glide时给列表item图片设置合理尺寸Glide.with(itemView.context) .load(url) .override(300, 300) .centerCrop() .into(imageView)指定尺寸不是多此一举它能让Glide在解码前就知道目标大小显著降低内存占用。列表滑动时Glide默认的缓存机制已经能应付大部分场景。5. 想继续进阶这几个方向能帮你省掉很多弯路如果你的项目里已经有一个正常的RecyclerView了下面这几个方向是紧接着会遇到的需求我先点出来免得你到时候到处找答案。5.1 多种item类型别再一个布局里拼命隐藏很多新人处理“列表里有广告、有普通内容、有标题”时喜欢用一个item布局然后根据数据类型隐藏或显示控件。这个方法在小项目能跑但维护一多就糟心。正确的做法是重写getItemViewType然后给不同类型返回各自的事ViewHolder。override fun getItemViewType(position: Int): Int { return when (items[position].type) { banner - TYPE_BANNER normal - TYPE_NORMAL else - TYPE_BANNER } } override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): VH { return when (viewType) { TYPE_BANNER - BannerVH(createView(parent, R.layout.item_banner)) else - NormalVH(createView(parent, R.layout.item_normal)) } }注意返回的viewType如果大数据量比较大不要直接用position当viewType而要用数据里的真实类型字段否则复用池完全失效。多类型item是RecyclerView最灵活的地方GridView和ListView很难做到这么干净。5.2 用DiffUtil替换整表刷新当你的列表需要和服务器数据做对比时手动去notify每个变化很痛苦。官方推荐的DiffUtil可以帮你计算两个列表的差异然后自动执行对应的notify方法既有动画又省性能。基础写法如下class ItemDiffCallback( private val oldList: ListMyData, private val newList: ListMyData ) : DiffUtil.Callback() { override fun getOldListSize() oldList.size override fun getNewListSize() newList.size override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean { return oldList[oldItemPosition].id newList[newItemPosition].id } override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean { return oldList[oldItemPosition] newList[newItemPosition] } }然后通过DiffUtil.calculateDiff(callback).dispatchUpdatesTo(adapter)执行更新。数据量几百条时这种计算很快但数据量上万条且item复杂时计算Diff本身也会有开销可以放到子线程这也是后话了。5.3 setHasFixedSize与stableIds两个不起眼但重要的开关如果你的列表内容长度已知且增删操作不会改变RecyclerView自身尺寸比如只用做竖向固定高度列表可以调用recyclerView.setHasFixedSize(true)这能让RecyclerView跳过测量过程的长度和大小计算减少布局开销。它必须在设置Adapter之前调用才最有效。setHasStableIds(true)配合Adapter的getItemId返回唯一id可以保证数据排序变化后RecyclerView尽量复用原来的ViewHolder而不是销毁重建。适用于那些item状态比较昂贵、需要保留的情况。这两个开关不是必需的但知道它们能解决什么比瞎开要好。5.4 上拉加载和下拉刷新怎么做RecyclerView自身没有下拉刷新官方建议配合SwipeRefreshLayout使用。上拉加载需要监听滑动到最底部recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() { override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) { super.onScrolled(recyclerView, dx, dy) val layoutManager recyclerView.layoutManager as LinearLayoutManager val lastVisible layoutManager.findLastVisibleItemPosition() if (lastVisible layoutManager.itemCount - 2) { // 触底加载更多 loadMore() } } })findLastVisibleItemPosition返回的是当前看到的最底部item位置与总item数相差小于等于2时就认为快到底了。这里的“2”是缓冲值可以按需调整。加载更多时记得通过状态位防止重复触发不然滑动时可能连发好几个请求。最后分享个小习惯我现在写任何列表页都会先把item的类型定义清楚、布局扁平化、确定好稳定id再动手写Adapter。一套流程走下来后面加需求、改样式的成本都会低很多。你如果真的想彻底掌握RecyclerView不用去看一堆源码解析就把这几个实战方向各写一个小Demo多类型列表、GridLayoutManager混排、瀑布流、DiffUtil刷新、上拉加载全部自己敲一遍自然就通了。