ViewPager点击Tab无响应，添加关联Fragment的Tab无显示无响应求助

嗨，我帮你梳理下开发中遇到Tab没响应、不显示，还有ViewPager点Tab没反应的常见问题和解决办法，都是实际踩过的坑～

一、先确认TabLayout和ViewPager的绑定是否到位 #

这是最容易出错的环节，必须完成双向绑定才能让两者联动：

• 一定要调用 tabLayout.setupWithViewPager(viewPager)，这行代码会自动把Tab的点击事件和ViewPager的页面切换关联起来，少了它Tab点了肯定没反应
• 如果是手动添加Tab，还要保证每个Tab对应PagerAdapter里的Fragment，且PagerAdapter的getCount()返回正确的数量

给你个MainActivity里的正确绑定示例：

// 先拿到控件实例
ViewPager viewPager = findViewById(R.id.view_pager);
TabLayout tabLayout = findViewById(R.id.tab_layout);

// 初始化适配器并设置给ViewPager
MyPagerAdapter pagerAdapter = new MyPagerAdapter(getSupportFragmentManager(), getLifecycle());
viewPager.setAdapter(pagerAdapter);

// 关键！绑定TabLayout和ViewPager，这步不能忘
tabLayout.setupWithViewPager(viewPager);

二、排查PagerAdapter的实现是否正确 #

PagerAdapter的几个核心方法必须写对，不然Tab要么不显示，要么切换无效：

• getCount()：必须返回你要展示的Fragment总数，要是返回0或者数量不对，Tab直接不显示
• getItem()：要准确返回对应位置的Fragment实例，不能返回null或者重复创建错误的Fragment
• getPageTitle()：如果需要Tab显示标题，这个方法得返回对应位置的标题文本，不然Tab会是空的

给你个适配AndroidX的正确PagerAdapter示例（用FragmentStatePagerAdapter，比旧的FragmentPagerAdapter更灵活）：

public class MyPagerAdapter extends FragmentStatePagerAdapter {
    private final List<Fragment> fragmentList = new ArrayList<>();
    private final List<String> tabTitleList = new ArrayList<>();

    public MyPagerAdapter(@NonNull FragmentManager fm, @NonNull Lifecycle lifecycle) {
        // 用BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT优化性能，只恢复当前显示的Fragment
        super(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT);
    }

    // 用来添加Fragment和对应Tab标题的方法
    public void addTabFragment(Fragment fragment, String tabTitle) {
        fragmentList.add(fragment);
        tabTitleList.add(tabTitle);
    }

    @NonNull
    @Override
    public Fragment getItem(int position) {
        return fragmentList.get(position);
    }

    @Override
    public int getCount() {
        // 返回Fragment的数量，也就是Tab的数量
        return fragmentList.size();
    }

    @Nullable
    @Override
    public CharSequence getPageTitle(int position) {
        // 返回对应Tab的标题
        return tabTitleList.get(position);
    }
}

然后在MainActivity里添加你的Fragment：

pagerAdapter.addTabFragment(new HomeFragment(), "首页");
pagerAdapter.addTabFragment(new MineFragment(), "我的");
viewPager.setAdapter(pagerAdapter);

三、检查布局文件有没有坑 #

• 确保TabLayout和ViewPager在同一个父布局下，没有被其他View（比如ScrollView、FrameLayout）遮挡，不然Tab可能点不到或者看不到
• 检查TabLayout的tabMode属性，设置成fixed（固定Tab，适合数量少的情况）或者scrollable（可滚动，适合Tab多的情况），默认如果Tab数量多可能会挤成一团显示不全
• ViewPager的宽高要设置正确，比如给它设android:layout_height="0dp"+android:layout_weight="1"，让它占满剩余空间，不然Fragment内容可能显示不出来

示例布局代码：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/tab_layout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:tabMode="fixed"
        app:tabGravity="fill"/>

    <androidx.viewpager.widget.ViewPager
        android:id="@+id/view_pager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"/>

</LinearLayout>

四、其他容易忽略的小问题 #

• 如果用了自定义Tab布局，要确保自定义布局的点击事件没有被拦截，并且通过tabLayout.getTabAt(position).setCustomView(customView)正确设置到Tab上
• 检查Fragment的onCreateView方法是否正确返回了View，要是返回null，就算Tab切换了也看不到Fragment内容
• 别不小心给TabLayout设置了setEnabled(false)或者android:clickable="false"，那样Tab肯定点不动

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