2、环境搭建与依赖配置：在 build.gradle 中添加 RecyclerView 依赖

好，咱们正式开始动手了。这一章其实特别简单，但也是很多新手翻车的地方。我见过不少同学，代码写得飞起，结果一运行直接报错——说白了，就是依赖没配对。

嗯，咱们先把地基打牢。环境搭好了，后面才能跑得顺。

2.1 你需要准备什么？

先看看你手头的工具。我个人习惯用 Android Studio，版本建议在 Arctic Fox 以上。Gradle 版本的话，7.0+ 比较稳。Kotlin 版本？1.5 以上基本都行。

你想想看，如果 IDE 版本太老，有些新特性可能不支持，到时候查 bug 查到怀疑人生。我去年帮一个学员排查问题，折腾了两小时，最后发现是他 Android Studio 4.2 里缺了个插件……

2.2 在 build.gradle 中添加 RecyclerView 依赖

好，核心操作来了。打开你的项目，找到 app/build.gradle 文件（注意不是顶层的那个）。在 dependencies 块里加上这一行：

dependencies {
    implementation("androidx.recyclerview:recyclerview:1.3.2")
}

就这么简单？对，就一行。但这里有几个坑，我踩过，你得注意。

版本号别乱写

我见过有人直接写 1.3.+，觉得这样能自动更新。嗯，千万别。Gradle 的动态版本号在团队协作时就是灾难——今天还能编译，明天就崩了。我曾经因为这事被同事吐槽过……

老老实实写死版本号。想升级？手动改，心里有数。

别用 support 库了

如果你在网上搜到类似 com.android.support:recyclerview-v7 的写法，直接忽略。那是老古董了。AndroidX 才是亲儿子。从 2018 年 Google 就推 AndroidX 了，现在新项目必须用。

2.3 同步与验证

加完依赖后，点击 Android Studio 右上角的「Sync Now」。等 Gradle 下载完，你会看到 BUILD SUCCESSFUL 的提示。

怎么验证配对了？简单。在 Activity 的布局文件里写个 RecyclerView 标签：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

如果能正常渲染预览，说明依赖生效了。如果报错「找不到这个类」——嗯，回去检查一下 build.gradle 有没有拼错单词。我犯过这种低级错误，把 recyclerview 写成了 recycleview，少了个 r。

2.4 知识体系一览

这一章的内容其实就三个点。我画了张图，帮你理清思路：

2.5 关于 Gradle 文件的小建议

你可能注意到，build.gradle 里还有 compileSdk、minSdk 这些配置。RecyclerView 对 minSdk 没有特殊要求，但建议至少设到 21（Android 5.0）。

为什么？因为 5.0 以下的设备占比已经很低了，而且很多新特性在低版本上跑不起来。你想想看，为了那 2% 的用户，多写一堆兼容代码，值吗？我个人觉得不值。

好，这一章就到这。环境搭好了，下一章咱们就开始写真正的代码了——创建 RecyclerView 的布局和 ViewHolder。到时候你会发现，前面这一步虽然简单，但没它真不行。

---