ViewPager与TabLayout联动异常：无法切换Fragment、内容不显示且标签消失

Hey there! Let's work through these ViewPager + TabLayout headaches together—they're super common, and once you spot the fixes, it'll click right away. Here's what's probably going wrong and how to fix each issue:

1. Why setupWithViewPager() makes your tabs vanish #

When you call tabLayout.setupWithViewPager(viewPager), it wipes out any tabs you added manually (like with tabLayout.addTab()) and replaces them with the titles from your ViewPager's adapter. If your adapter doesn't override the getPageTitle(int position) method, there's no title to display—so tabs disappear or show up empty.

Fix it like this:
First, make your FragmentPagerAdapter (or FragmentStatePagerAdapter) override getPageTitle() to return the correct tab names:

public class MyTabAdapter extends FragmentPagerAdapter {
    private final List<Fragment> fragmentList = new ArrayList<>();
    private final List<String> tabTitles = new ArrayList<>();

    public MyTabAdapter(FragmentManager fm) {
        super(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT);
    }

    // Method to add fragments and their titles
    public void addFragment(Fragment fragment, String title) {
        fragmentList.add(fragment);
        tabTitles.add(title);
    }

    @Override
    public CharSequence getPageTitle(int position) {
        return tabTitles.get(position); // This feeds titles directly to TabLayout
    }

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

    @Override
    public int getCount() {
        return fragmentList.size();
    }
}

Then, in your Activity, set the adapter to ViewPager first, then link to TabLayout:

// Initialize adapter and add fragments
MyTabAdapter adapter = new MyTabAdapter(getSupportFragmentManager());
adapter.addFragment(new FirstFragment(), "Tab 1");
adapter.addFragment(new SecondFragment(), "Tab 2");

// Link everything up in this exact order!
viewPager.setAdapter(adapter);
tabLayout.setupWithViewPager(viewPager);

Don't add tabs manually before this—let the adapter handle it via getPageTitle().

2. Can't swipe between Fragments #

This almost always comes down to one of these easy-to-miss issues:

• No adapter attached to ViewPager: Double-check you called viewPager.setAdapter(adapter)—without this, ViewPager has no content to swipe through.
• getCount() returns 0: Make sure your adapter's getCount() returns the size of your fragment list (not 0). If it returns 0, ViewPager thinks there's nothing to show.
• ViewPager has zero height: If you set android:height="wrap_content" on ViewPager, it might collapse to 0 height if your Fragments don't have immediate content. Try setting android:height="match_parent" or a fixed height (like 300dp) to test this.
• Parent view blocks touch: If your ViewPager is inside a ScrollView or another view that intercepts touch events, it might prevent swiping. Try moving ViewPager outside or adjusting touch event handling.

3. Fragment text isn't showing up #

Let's troubleshoot the most likely causes:

• onCreateView() returns null: Make sure you're inflating your Fragment's layout correctly. A common mistake is forgetting to return the inflated view:

  @Override
  public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
      // Correct: inflate and return the layout
      View view = inflater.inflate(R.layout.fragment_first, container, false);
      // Now find your text view and set text
      TextView textView = view.findViewById(R.id.fragment_text);
      textView.setText("Hello from Fragment 1!");
      return view;
  
      // Wrong: don't return null or skip inflating!
  }
  

• ID mismatch: Double-check that the ID of your TextView in the Fragment's XML matches the one you use in findViewById(). A typo here means the text view is never found, so no text shows up.
• Fragment isn't instantiated correctly: In your adapter's getItem() method, make sure you're returning a new instance of the Fragment (not a null or reused instance that's not set up properly).
• ViewPager is invisible: If ViewPager has zero height (from the earlier issue), your Fragment's content will be hidden too—fix the ViewPager's layout first.

Quick Sanity Checklist #

Before you dive back in, run through these checks:

• Did you set the adapter to ViewPager before calling setupWithViewPager()?
• Does your adapter override getPageTitle()?
• Does getCount() return the correct number of Fragments?
• Is your Fragment's onCreateView() inflating the layout and returning it?
• Is the ViewPager's layout set to match_parent (or a non-zero height)?

If you still hit snags, sharing your adapter code and Fragment implementations would help narrow things down further!

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