5、Fragment之间的跳转：使用NavController进行页面跳转、传递简单参数、处理返回栈

好，咱们今天聊点实战的。前面几章我们把Navigation组件的架子搭起来了，nav_graph也画好了，但页面之间怎么跳？怎么传数据？返回栈怎么管？这些才是每天写代码时真正要面对的问题。

我个人习惯把Navigation理解成一个「智能的页面调度员」。你告诉它想去哪，它帮你找到对应的Fragment，帮你处理好参数，还帮你管理好返回的路径。说白了，你只需要关心「去哪」和「带什么」，剩下的脏活累活都交给NavController。

5.1 获取NavController：跳转的起点

要跳转，先得拿到NavController。在Fragment里获取的方式很简单：

// 在Fragment中获取NavController
val navController = findNavController()

这行代码背后做了不少事——它会沿着Fragment的父容器往上找，直到找到NavHostFragment，然后拿到对应的NavController。我在项目中遇到过有人直接在Activity里用Navigation.findNavController(this, R.id.nav_host_fragment)，其实效果一样，但Fragment里直接用findNavController()更简洁。

5.2 基础跳转：用navigate()去你想去的地方

拿到NavController后，跳转就一行代码的事：

// 从HomeFragment跳转到DetailFragment
findNavController().navigate(R.id.action_home_to_detail)

这里的R.id.action_home_to_detail是你在nav_graph里定义的Action ID。你可能会问：能不能直接用目标Fragment的ID？当然可以：

// 直接用目标Fragment的ID跳转
findNavController().navigate(R.id.detailFragment)

这两种方式有什么区别？嗯，用Action的好处是——它绑定了源和目标之间的「导航规则」，比如过渡动画、参数默认值等。直接用目标ID则更灵活，但失去了这些附加配置。我个人习惯在明确的业务跳转中用Action，在动态路由场景中用目标ID。

5.3 传递简单参数：Safe Args vs Bundle

页面跳转不带参数？那基本不可能。Navigation提供了两种传参方式，我分别说说。

5.3.1 使用Safe Args（推荐）

Safe Args是Navigation官方推荐的传参方式。它通过生成类型安全的类，让你在编译期就能发现参数类型错误。配置起来也很简单：

首先，在nav_graph里定义参数：

<fragment
    android:id="@+id/detailFragment"
    android:name="com.example.app.DetailFragment"
    android:label="详情页">
    <argument
        android:name="itemId"
        android:defaultValue="0"
        app:argType="integer" />
    <argument
        android:name="itemName"
        android:defaultValue="未知"
        app:argType="string" />
</fragment>

然后，在跳转时使用生成的Directions类：

// 使用Safe Args跳转并传参
val action = HomeFragmentDirections.actionHomeToDetail(
    itemId = 42,
    itemName = "Android进阶指南"
)
findNavController().navigate(action)

在目标Fragment中接收参数：

// 使用Safe Args接收参数
val args: DetailFragmentArgs by navArgs()
val id = args.itemId
val name = args.itemName

你看，类型安全、代码可读性强、还支持默认值。我在项目中一直用这种方式，从来没出过参数类型不匹配的问题。

5.3.2 使用Bundle（传统方式）

如果你不想引入Safe Args，或者需要动态构建参数，直接用Bundle也行：

// 使用Bundle传参
val bundle = Bundle().apply {
    putInt("itemId", 42)
    putString("itemName", "Android进阶指南")
}
findNavController().navigate(R.id.detailFragment, bundle)

接收时在Fragment的onViewCreated里取：

// 使用Bundle接收参数
val itemId = arguments?.getInt("itemId") ?: 0
val itemName = arguments?.getString("itemName") ?: "未知"

5.4 处理返回栈：回退与清栈

返回栈是Navigation里最容易踩坑的地方。你想想看，用户从A跳到B，再跳到C，然后按返回键——应该回到B还是A？如果C是一个「确认订单」页面，返回时应该直接回到首页还是回到购物车？

5.4.1 默认返回行为

Navigation默认帮你维护了一个返回栈。每次navigate()时，当前Fragment会被压入栈中。用户按返回键时，自动弹出栈顶Fragment。这个行为跟Activity的返回栈很像，你不需要额外写代码。

// 默认返回：按返回键自动回退到上一个Fragment
// 不需要任何额外代码

5.4.2 手动回退：popBackStack()

有时候你需要代码控制回退：

// 回退到上一个Fragment
findNavController().popBackStack()

// 回退到指定Fragment（比如回退到HomeFragment）
findNavController().popBackStack(R.id.homeFragment, false)

第二个参数inclusive表示是否包含目标Fragment本身。如果设为true，连HomeFragment也会被弹出栈。

5.4.3 清空返回栈：避免栈堆积

这是我在项目中遇到最多的问题。比如用户从首页 -> 登录 -> 个人中心，如果登录成功后不清理返回栈，用户按返回键会回到登录页——这显然不合理。

解决方案是在跳转时使用popUpTo：

// 跳转到个人中心，并清空登录页之前的栈
findNavController().navigate(
    R.id.profileFragment,
    null,
    NavOptions.Builder()
        .setPopUpTo(R.id.homeFragment, inclusive = false) // 保留HomeFragment
        .build()
)

或者在nav_graph里直接配置：

<action
    android:id="@+id/action_login_to_profile"
    app:destination="@id/profileFragment"
    app:popUpTo="@id/homeFragment"
    app:popUpToInclusive="false" />

5.5 知识体系总览

下面这张图把本章的核心知识点串起来了，你可以对照着回顾一下：

5.6 避坑指南

最后分享几个我踩过的坑，希望能帮你省点时间：

• 重复跳转问题： 用户快速点击按钮时，可能会触发多次navigate()。我建议在点击后立即禁用按钮，或者使用Navigation.findNavController(view).currentDestination?.id判断当前页面是否已经是目标页面。
• Fragment重建后参数丢失： 如果Fragment被系统重建，arguments会自动恢复，但如果你把参数存在了ViewModel里，记得用SavedStateHandle保存。
• popBackStack()返回false： 当返回栈里只有一个Fragment时，popBackStack()会返回false。这时候你应该处理「退出应用」的逻辑，而不是继续回退。

嗯，关于Fragment跳转的核心内容就这些了。记住：NavController是你的导航大脑，Safe Args是你的传参利器，返回栈管理是你的避坑法宝。把这三点用好，Navigation这块基本就稳了。

---