如何实现仅显示单个Item、横向滑动切换内容的RecyclerView？

步骤1：替换横向LinearLayout为RecyclerView #

首先在布局文件中替换原有的横向LinearLayout为RecyclerView，配置基础属性：

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/imageRecyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />

步骤2：让Item占满屏幕宽度 #

在RecyclerView的Adapter中，将每个图片Item的宽度设置为屏幕宽度，确保同一时间仅显示一张图片：

Adapter代码： #

class ImageAdapter(private val imageList: List<Int>) : RecyclerView.Adapter<ImageAdapter.ImageViewHolder>() {
    private var screenWidth = 0

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ImageViewHolder {
        // 获取当前屏幕宽度
        val displayMetrics = parent.context.resources.displayMetrics
        screenWidth = displayMetrics.widthPixels

        val view = LayoutInflater.from(parent.context).inflate(R.layout.item_image, parent, false)
        // 强制Item宽度等于屏幕宽度
        val layoutParams = view.layoutParams
        layoutParams.width = screenWidth
        view.layoutParams = layoutParams
        return ImageViewHolder(view)
    }

    override fun onBindViewHolder(holder: ImageViewHolder, position: Int) {
        holder.imageView.setImageResource(imageList[position])
    }

    override fun getItemCount() = imageList.size

    class ImageViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val imageView: ImageView = itemView.findViewById(R.id.itemImageView)
    }
}

Item布局（item_image.xml）： #

<ImageView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/itemImageView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scaleType="centerCrop" />

步骤3：添加滑动对齐效果 #

通过LinearSnapHelper实现滑动后自动居中到当前Item，达到类似ViewPager的切换体验：

val recyclerView = findViewById<RecyclerView>(R.id.imageRecyclerView)
// 替换为你的图片资源列表
val imageList = listOf(R.drawable.img_1, R.drawable.img_2, R.drawable.img_3)
val adapter = ImageAdapter(imageList)

recyclerView.adapter = adapter
// 明确设置横向LayoutManager
val layoutManager = LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)
recyclerView.layoutManager = layoutManager

// 绑定SnapHelper实现滑动对齐
val snapHelper = LinearSnapHelper()
snapHelper.attachToRecyclerView(recyclerView)

可选优化：关闭过度滚动效果 #

如果不需要首尾的弹性滚动反馈，可以添加：

recyclerView.overScrollMode = View.OVER_SCROLL_NEVER

内容的提问来源于stack exchange，提问作者Ahmet Özaydın