RecyclerView条目添加margin后预览间距正常但真机不显示如何解决

问题原因 #

你遇到的margin不生效是Android开发中RecyclerView的常见问题，核心原因是Adapter加载条目布局时的inflate参数错误：
XML预览时会自动将条目布局挂载到RecyclerView父容器下，所以margin属性会正常解析；但实际运行时如果Adapter的onCreateViewHolder方法中inflate布局时没有传入父容器参数，条目根布局的margin属性会直接丢失，导致运行时间距不生效。

解决方案 #

方案1：修改Adapter的inflate代码（最便捷） #

找到你的RecyclerView Adapter的onCreateViewHolder方法，将原来的布局加载代码修改为正确写法：

// 错误写法（不传parent会丢失根布局LayoutParams）
// val view = LayoutInflater.from(parent.context).inflate(R.layout.city_item_layout, null)
// 正确写法
val view = LayoutInflater.from(parent.context).inflate(R.layout.city_item_layout, parent, false)

修改后条目根布局设置的8dp margin就会正常生效，和预览效果一致。

方案2：使用ItemDecoration设置间距（官方推荐） #

如果不想修改条目布局和inflate逻辑，推荐使用RecyclerView官方提供的ItemDecoration机制实现间距，适配性更强：

1. 自定义间距装饰类：

import android.graphics.Rect
import android.view.View
import androidx.recyclerview.widget.RecyclerView

class SpaceItemDecoration(private val spacePx: Int) : RecyclerView.ItemDecoration() {
    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        // 按需设置四个方向的间距，以下是纵向列表的通用设置
        outRect.left = spacePx
        outRect.right = spacePx
        outRect.bottom = spacePx
        // 第一个条目额外添加上间距
        if (parent.getChildAdapterPosition(view) == 0) {
            outRect.top = spacePx
        }
    }
}

2. 给RecyclerView添加装饰：

// 注意需要将dp转为px，不要直接传8
val spacePx = dpToPx(8, resources.displayMetrics)
city_list_recycler_view.addItemDecoration(SpaceItemDecoration(spacePx))

// dp转px工具方法
fun dpToPx(dp: Int, displayMetrics: DisplayMetrics): Int {
    return (dp * displayMetrics.density).toInt()
}

方案3：调整条目布局结构 #

如果前两种方案都不适用，可以修改条目布局，将根布局的margin替换为padding，根布局背景设为透明，内部嵌套一层ConstraintLayout承载原来的背景、内容和点击逻辑，padding属性不会受inflate参数影响。

内容的提问来源于stack exchange，提问作者Jesse Okoro