如何为ViewPager+TabLayout创建的标签页分配唯一Tab ID？

这问题我之前踩过坑——用Tab的位置当唯一ID确实不靠谱，因为Tab的位置会随着增删操作动态变化，后续的标签页点击、删除后都会出现位置和实际Tab不匹配的情况。下面给你一套可靠的解决方案：

核心思路：用自定义数据类绑定唯一ID #

不要依赖Tab的位置，而是给每个标签页创建一个带唯一标识的数据模型，用这个模型来管理所有Tab的状态，ViewPager的Adapter也基于这个模型列表来工作。

步骤1：创建Tab数据模型 #

定义一个数据类，存储唯一ID、标签标题，以及创建对应子Fragment的工厂方法（方便传递参数）：

import android.os.Bundle
import androidx.fragment.app.Fragment

data class TabItem(
    val id: String, // 唯一标识，用UUID或自增整数生成
    val title: String,
    // 工厂方法：返回对应子Fragment的实例，可传递ID参数
    val fragmentProvider: () -> Fragment
)

// 子Fragment的创建工具方法（示例）
fun createChildFragment(tabId: String): Fragment {
    return ChildFragment().apply {
        arguments = Bundle().apply {
            putString("TAB_ID", tabId)
        }
    }
}

步骤2：实现基于数据模型的ViewPager Adapter #

用FragmentStateAdapter（比旧的FragmentPagerAdapter更高效），内部维护TabItem列表，所有增删操作都通过修改列表并通知Adapter更新：

import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentManager
import androidx.lifecycle.Lifecycle
import androidx.viewpager2.adapter.FragmentStateAdapter

class TabPagerAdapter(
    fragmentManager: FragmentManager,
    lifecycle: Lifecycle
) : FragmentStateAdapter(fragmentManager, lifecycle) {

    private val tabItems = mutableListOf<TabItem>()

    // 新增标签页
    fun addTab(newTab: TabItem) {
        tabItems.add(newTab)
        notifyItemInserted(tabItems.size - 1)
    }

    // 根据ID删除标签页
    fun removeTabById(tabId: String) {
        val index = tabItems.indexOfFirst { it.id == tabId }
        if (index != -1) {
            tabItems.removeAt(index)
            notifyItemRemoved(index)
        }
    }

    // 根据位置获取TabItem
    fun getTabItemAtPosition(position: Int): TabItem? {
        return tabItems.getOrNull(position)
    }

    override fun getItemCount(): Int = tabItems.size

    override fun createFragment(position: Int): Fragment {
        return tabItems[position].fragmentProvider()
    }
}

步骤3：关联TabLayout、ViewPager与新增逻辑 #

初始化Adapter，绑定TabLayout和ViewPager，处理新增按钮的点击事件：

import android.os.Bundle
import android.widget.Button
import androidx.appcompat.app.AppCompatActivity
import androidx.viewpager2.widget.ViewPager2
import com.google.android.material.tabs.TabLayout
import com.google.android.material.tabs.TabLayoutMediator
import java.util.UUID

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val tabLayout = findViewById<TabLayout>(R.id.tabLayout)
        val viewPager = findViewById<ViewPager2>(R.id.viewPager)
        val addTabBtn = findViewById<Button>(R.id.addTabBtn)

        // 初始化Adapter
        val adapter = TabPagerAdapter(supportFragmentManager, lifecycle)
        viewPager.adapter = adapter

        // 关联TabLayout和ViewPager，设置标签标题
        TabLayoutMediator(tabLayout, viewPager) { tab, position ->
            tab.text = adapter.getTabItemAtPosition(position)?.title
        }.attach()

        // 新增标签页按钮逻辑
        addTabBtn.setOnClickListener {
            // 生成唯一ID（UUID保证全局唯一）
            val uniqueTabId = UUID.randomUUID().toString()
            val newTab = TabItem(
                id = uniqueTabId,
                title = "标签 ${adapter.itemCount + 1}",
                fragmentProvider = { createChildFragment(uniqueTabId) }
            )
            adapter.addTab(newTab)
            // 自动切换到新添加的标签页
            viewPager.currentItem = adapter.itemCount - 1
        }
    }
}

步骤4：子Fragment中使用唯一ID #

在子Fragment中获取传递的Tab ID，点击按钮时直接用这个ID显示Toast：

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import android.widget.Button
import android.widget.Toast
import androidx.fragment.app.Fragment

class ChildFragment : Fragment() {
    private var tabId: String? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 获取传递的Tab ID
        tabId = arguments?.getString("TAB_ID")
    }

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val view = inflater.inflate(R.layout.fragment_child, container, false)
        view.findViewById<Button>(R.id.toastBtn).setOnClickListener {
            Toast.makeText(context, "当前标签ID：$tabId", Toast.LENGTH_SHORT).show()
        }
        return view
    }
}

为什么之前的方法失效？ #

1. 位置动态变化：新增/删除标签页后，原有Tab的位置会改变，导致你依赖位置获取的"ID"完全不对应实际Tab
2. ViewPager复用机制：ViewPager会回收离屏的Fragment，当你切换回旧标签时，位置可能已经和初始创建时不同

用自定义唯一ID绑定Tab的方式，完全摆脱了对位置的依赖，不管怎么增删标签，每个Tab的ID都是固定且唯一的，逻辑不会出错。

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