如何实现ViewPager加载Fragment仅首次显示时加载且后续复用

嘿，这个需求正是Android开发里经典的Fragment懒加载场景，我之前做项目的时候也遇到过一模一样的问题——用setOffscreenPageLimit(4)虽然能保留所有Fragment，但初始就加载全部的做法太耗内存了，完全不符合我们要的“按需加载”。下面给你分享两个靠谱的实现方案，分旧版ViewPager和新版ViewPager2两种情况：

方案一：旧版ViewPager + FragmentPagerAdapter（兼容传统项目） #

核心思路是利用Fragment的setUserVisibleHint方法判断当前Fragment是否对用户可见，再结合视图初始化状态、数据加载状态的标记，实现“仅当可见且未加载时才加载数据”的逻辑。

步骤与代码示例： #

1. 给Fragment添加两个标记位，分别跟踪视图是否创建完成、数据是否已加载：
2. 重写setUserVisibleHint，在Fragment变为可见时触发加载（需满足视图已创建、数据未加载的条件）；
3. 在onCreateView中初始化视图后，判断如果当前Fragment已经是可见状态，立即触发加载；
4. 视图销毁时重置标记位，避免Fragment复用出现异常。

public class LazyLoadFragment extends Fragment {
    // 标记视图是否初始化完成
    private boolean isViewCreated = false;
    // 标记数据是否已加载完成
    private boolean isDataLoaded = false;

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View rootView = inflater.inflate(R.layout.your_fragment_layout, container, false);
        // 这里初始化你的视图控件（比如RecyclerView、TextView等）
        isViewCreated = true;
        
        // 如果当前Fragment已经处于可见状态，直接触发加载
        if (getUserVisibleHint() && !isDataLoaded) {
            loadData();
        }
        return rootView;
    }

    @Override
    public void setUserVisibleHint(boolean isVisibleToUser) {
        super.setUserVisibleHint(isVisibleToUser);
        // 当Fragment对用户可见、视图已创建、数据未加载时，执行加载逻辑
        if (isVisibleToUser && isViewCreated && !isDataLoaded) {
            loadData();
        }
    }

    // 你的数据加载逻辑（比如网络请求、本地数据库查询等）
    private void loadData() {
        // 示例：模拟网络请求
        new Handler().postDelayed(() -> {
            // 加载完成后标记数据已加载
            isDataLoaded = true;
            // 更新UI操作
        }, 1000);
    }

    @Override
    public void onDestroyView() {
        super.onDestroyView();
        // 视图销毁时重置标记，防止Fragment复用状态混乱
        isViewCreated = false;
        isDataLoaded = false;
    }
}

方案二：新版ViewPager2 + FragmentStateAdapter（推荐新项目使用） #

ViewPager2是Google推出的ViewPager升级版，原生支持更合理的懒加载逻辑，默认只会预加载左右各1个页面，而且可以通过生命周期监听更优雅地实现按需加载。

步骤与代码示例： #

利用Fragment的生命周期回调，监听ON_RESUME事件（此时Fragment真正被显示到前台），结合数据加载标记位，确保只加载一次：

public class LazyLoadFragment extends Fragment {
    private boolean isDataLoaded = false;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        
        // 监听生命周期，当Fragment进入RESUMED状态时触发加载
        getViewLifecycleOwner().getLifecycle().addObserver(new LifecycleEventObserver() {
            @Override
            public void onStateChanged(@NonNull LifecycleOwner source, @NonNull Lifecycle.Event event) {
                if (event == Lifecycle.Event.ON_RESUME && !isDataLoaded) {
                    loadData();
                    isDataLoaded = true;
                    // 加载完成后移除观察者，避免重复触发
                    source.getLifecycle().removeObserver(this);
                }
            }
        });
    }

    private void loadData() {
        // 你的数据加载逻辑
        // 加载完成后更新UI
    }
}

关键注意事项： #

• ❌ 不要使用setOffscreenPageLimit(4)：这个方法会强制ViewPager预加载所有标签页的Fragment，完全违背懒加载的初衷，还会浪费大量内存。
• 旧版ViewPager注意点：setUserVisibleHint可能会在onCreateView之前被调用，所以必须判断isViewCreated标记位，防止空指针异常。
• ViewPager2优势：不仅原生支持懒加载，还解决了旧版ViewPager的很多bug（比如Fragment状态混乱、滑动卡顿等），新项目优先推荐使用。

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