Android：TabLayout关联ViewPager后Tab图标切换Fragment失效问题

问题根源 #

你当前的实现同时用了两个冲突的Fragment切换机制：

• ViewPager + FragmentStatePagerAdapter：设置适配器后，ViewPager会自动接管Fragment的创建、切换与生命周期管理，和TabLayout绑定后，点击Tab会触发ViewPager切换到对应位置的Fragment。
• 自定义TabLayout.OnTabSelectedListener：你在监听器里手动调用replaceFragment替换Fragment，但这个操作会被ViewPager的内部机制覆盖——相当于你刚手动换了Fragment，ViewPager又立刻切回了它管理的实例，所以看起来点击Tab没效果。

解决方案（推荐：让TabLayout与ViewPager自动联动） #

我们只保留ViewPager的适配器机制，移除自定义的Tab选中监听器，同时让两者绑定，这样既能实现滑动切换，也能实现点击Tab图标切换，且两者状态完全同步。

修改步骤 #

1. 删掉自定义的Tab选中监听器：移除navigationTabs.addOnTabSelectedListener(...)整个代码块，包括里面的onTabSelected等方法。
2. 绑定TabLayout与ViewPager：设置完ViewPager适配器后，调用setupWithViewPager关联两者，同时重新设置Tab图标（因为setupWithViewPager会重置Tab内容）。
3. 清理冗余代码：删掉profileFragment、swipeFragment这些手动维护的Fragment实例变量，以及replaceFragment函数——ViewPager适配器会全权负责Fragment管理。

修改后的代码 #

MeetActivity.kt

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

        // 初始化Tab并设置图标
        val profileTab = navigationTabs.newTab().apply {
            icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_profile)
        }
        val swipeTab = navigationTabs.newTab().apply {
            icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_swipe)
        }
        val matchesTab = navigationTabs.newTab().apply {
            icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_matches)
        }

        navigationTabs.apply {
            addTab(profileTab)
            addTab(swipeTab)
            addTab(matchesTab)
        }

        // 设置ViewPager适配器
        val adapter = PagerAdapter(supportFragmentManager, navigationTabs.tabCount) 
        fragmentContainer.adapter = adapter 

        // 绑定TabLayout与ViewPager，绑定后重新设置图标（避免被重置）
        navigationTabs.setupWithViewPager(fragmentContainer)
        navigationTabs.apply {
            getTabAt(0)?.icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_profile)
            getTabAt(1)?.icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_swipe)
            getTabAt(2)?.icon = ContextCompat.getDrawable(this@MeetActivity, R.drawable.tab_matches)
        }
    } 
}

PagerAdapter.kt

class PagerAdapter(fm: FragmentManager, private val mNoOfTabs: Int) : FragmentStatePagerAdapter(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT) { 
    override fun getItem(position: Int): Fragment { 
        return when (position) { 
            0 -> ProfileFragment() 
            1 -> SwipeFragment() 
            2 -> MatchesFragment() 
            else -> throw IllegalArgumentException("无效的Tab位置: $position") 
        } 
    } 

    override fun getCount() = mNoOfTabs 

    // 不需要Tab文字标题，返回null即可
    override fun getPageTitle(position: Int): CharSequence? {
        return null
    }
}

额外说明 #

• 为什么要重新设置Tab图标？因为setupWithViewPager会清除你手动添加的Tab，然后根据适配器的getCount重新生成Tab，所以必须重新给每个位置的Tab设置图标。
• 如果想避免Fragment重复创建，可以在适配器里缓存Fragment实例；另外FragmentStatePagerAdapter已被废弃，长期来看建议迁移到ViewPager2 + FragmentStateAdapter，这是Google推荐的最新方案。

内容的提问来源于stack exchange，提问作者sir-haver