SwiftUI 导航内部：NavigationStack 的真实工作原理

Source: Dev.to

Overview

SwiftUI 的导航表面上看起来很简单——直到它不再如此。常见的症状包括：

• 视图意外重新创建
• 导航栈被重置
• 返回按钮消失
• 在 push 时状态丢失
• 深链接行为不一致
• 大型流程中性能下降

根本原因几乎总是对 SwiftUI 导航内部工作方式的误解。本文从内部阐释 NavigationStack——身份、路径差分、生命周期和状态——使用现代 SwiftUI 模型。

NavigationStack Basics

SwiftUI 的导航是 状态驱动 的，而不是命令式的。你并不“push 视图”；你提供导航数据。

NavigationStack(path: $path) {
    RootView()
}

path 只是一个路由数组：

var path: [Route]

SwiftUI 会：

1. 比较旧的路径和新的路径
2. 计算差异
3. 应用插入/删除

没有显式的 push API。

Defining Routes

enum Route: Hashable {
    case profile(id: String)
    case settings
}

Route Identity

SwiftUI 对路由进行哈希；路由的身份决定导航栈的行为。不稳定的值会导致导航出错。

错误示例（每次都有新身份）：

case profile(id: UUID())

正确示例（身份稳定）：

case profile(id: user.id)

View Identity vs. Route Identity

• 路由身份 → 控制导航栈
• 视图身份 → 控制状态保留

如果路由改变，SwiftUI 会移除对应的目标视图，销毁其视图身份。因此，@State 和 @StateObject 会被重置。这是预期行为。

Managing the Path

设置 path 会替换整个栈：

path = [.profile(id: "123")]

这会清空栈、推入新目标、销毁中间视图，并重置它们的状态和动画。

若要 追加：

path.append(.profile(id: "123"))

Navigation Destination

.navigationDestination(for: Route.self) { route in
    ProfileView(id: route.id)
}

• 该闭包会被多次调用。
• 它 不 持久化视图。
• 请 不要 在这里存放状态。

Correct State Placement

.navigationDestination {
    ProfileView(id: id)
}

在 ProfileView 中：

@StateObject private var vm = ProfileViewModel(id: id)

或从父作用域（例如 ViewModel、AppState）注入一个稳定的实例。

Lifecycle Implications

内部实现：

• Push → 创建视图
• Pop → 销毁视图
• Re‑push → 全新身份

因此：

• onAppear 可能会运行多次。
• onDisappear 并 不 保证对象被释放。
• .task 会自动取消，更适合作为副作用的入口，而不是 onAppear。

Deep Linking

深链接其实就是一次路径赋值：

path = [.profile(id: "999")]

不需要特殊 API。相同的身份、状态重置和生命周期规则同样适用，这也是在配合中心化 AppState 时深链接能够正常工作的原因。

Debugging Checklist

• 路径是否改变？
• 是 替换 还是 追加？
• 路由身份是否变化？
• 父视图是否重新创建？
• 状态是属于视图本身还是提升到了上层？

大多数导航 bug 实际上是状态管理 bug。

Conceptual Flow

NavigationStack
   ↓
Path (data)
   ↓
Diff
   ↓
View lifecycle
   ↓
State preserved or destroyed

Conclusion

当你把导航视为数据差分时，一切都能解释通。SwiftUI 的导航具备：

• 确定性
• 状态驱动
• 对身份敏感

只有在模型错误时才会感觉“有 bug”。理解 路径差分、路由身份、视图生命周期 与 状态所有权，即可让导航变得可预测、可测试、可扩展——即使在非常大的应用中也是如此。