StaggeredGridLayoutManager和GridLayoutManager

一、它是什么？

StaggeredGridLayoutManager是Android RecyclerView专用的布局管理器，用来实现不规则瀑布流布局。

特点：

• 多列网格（2 列、3 列…）
• 每一项高度不固定，自动错落排列
• 不会像普通 GridLayoutManager 那样强制等高
• 最常见场景：商品列表、图片瀑布流、笔记卡片

二、基础使用（直接复制可用）

1. 依赖（AndroidX）

RecyclerView 已经是 AndroidX 自带，无需额外依赖。

2. 代码设置（最常用）

java

运行

// 2 列瀑布流，垂直方向 StaggeredGridLayoutManager staggeredGridLayoutManager = new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL); recyclerView.setLayoutManager(staggeredGridLayoutManager);

参数说明：

• 2：列数
• VERTICAL：垂直滚动（也可以用 HORIZONTAL 横向）

3. Kotlin 版本

kotlin

val layoutManager = StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL) recyclerView.layoutManager = layoutManager

三、关键注意点（90% 人踩坑）

1. 瀑布流 item 高度必须自适应

item 布局里的根布局不能写固定高度，要用wrap_content。

错误 ❌

xml

android:layout_height="200dp"

正确 ✅

xml

android:layout_height="wrap_content"

2. 解决滑动时 item 乱序、跳动、高度错乱

java

运行

// 防止回收复用导致的位置错乱 staggeredGridLayoutManager.setGapStrategy(StaggeredGridLayoutManager.GAP_HANDLING_NONE);

3. 滑动到顶部不自动跳动

java

运行

staggeredGridLayoutManager.setReverseLayout(false);

四、和其他布局管理器的区别

表格

五、常见效果示例

• 淘宝商品列表
• 小红书图片瀑布流
• 花瓣网、Pinterest 风格布局
• 多列卡片流