NavigationStack初始化路径后返回时onAppear不触发的问题及解决思路

问题原因 #

当通过初始路径直接初始化NavigationStack时，路径上的所有视图会被一次性渲染并加入导航栈，但SwiftUI不会为这些视图建立完整的“入栈/出栈”生命周期触发逻辑。虽然初始化时所有视图的onAppear都会触发，但当你从初始路径返回时，上层视图只是从栈的后台层级被带到前台，SwiftUI不会重复触发它们的onAppear——因为这些视图并未被销毁重建，SwiftUI默认认为它们仍处于活跃状态。

而手动通过NavigationLink导航时，每个视图是被动态创建并逐个推入栈中，此时SwiftUI会完整跟踪每个视图的生命周期，返回时栈中视图的onAppear会按预期触发。

替代追踪方案 #

既然无法依赖onAppear实现跨场景的屏幕追踪，我们可以直接监听NavigationPath的变化，以此来实时获取当前显示的屏幕：

方案1：直接监听路径变化（基础版） #

通过onChange监听navigationPath的更新，根据路径的最后一个元素判断当前屏幕（路径为空时对应根视图View 0）：

import SwiftUI

struct SwiftUIView: View {
    @State private var navigationPath: NavigationPath
    @State private var currentScreen: Int? = nil

    init() {
        var startPath = NavigationPath()
        startPath.append(1)
        startPath.append(2)
        self._navigationPath = State(initialValue: startPath)
        self._currentScreen = State(initialValue: 2) // 初始路径最后一个元素对应当前屏幕
    }

    var body: some View {
        NavigationStack(path: $navigationPath) {
            Text("View 0")
                .navigationDestination(for: Int.self) { number in
                    MyDestinationView(number: number)
                }
            NavigationLink("Next", value: 1)
        }
        .onChange(of: navigationPath) { newPath in
            // 路径为空时是View 0，否则取最后一个元素作为当前屏幕标识
            currentScreen = newPath.last as? Int
            print("当前显示屏幕: \(currentScreen ?? 0)")
        }
    }
}

struct MyDestinationView: View {
    let number: Int
    var body: some View {
        VStack {
            Text("I'm view: \(number)")
            NavigationLink("Next", value: number + 1)
        }
    }
}

#Preview {
    SwiftUIView()
}

方案2：全局导航状态管理（进阶版） #

如果需要在NavigationStack外部（比如其他视图、ViewModel中）追踪屏幕状态，可以用ObservableObject封装导航逻辑：

import SwiftUI
import Combine

class NavigationManager: ObservableObject {
    @Published var navigationPath = NavigationPath()
    @Published var currentScreen: Int? = nil

    init(initialPath: NavigationPath) {
        self.navigationPath = initialPath
        self.currentScreen = initialPath.last as? Int
        setupPathObserver()
    }

    // 更新当前屏幕的方法
    private func updateCurrentScreen() {
        currentScreen = navigationPath.last as? Int
    }

    // 监听路径变化自动更新
    private func setupPathObserver() {
        $navigationPath
            .sink { [weak self] _ in
                self?.updateCurrentScreen()
            }
            .store(in: &cancellables)
    }

    private var cancellables = Set<AnyCancellable>()
}

struct SwiftUIView: View {
    @StateObject private var navManager = NavigationManager(initialPath: {
        var path = NavigationPath()
        path.append(1)
        path.append(2)
        return path
    }())

    var body: some View {
        NavigationStack(path: $navManager.navigationPath) {
            Text("View 0")
                .navigationDestination(for: Int.self) { number in
                    MyDestinationView(number: number)
                }
            NavigationLink("Next", value: 1)
        }
        .onReceive(navManager.$currentScreen) { screen in
            print("当前显示屏幕: \(screen ?? 0)")
            // 在这里可以将屏幕状态同步到外部逻辑
        }
    }
}

struct MyDestinationView: View {
    let number: Int
    var body: some View {
        VStack {
            Text("I'm view: \(number)")
            NavigationLink("Next", value: number + 1)
        }
    }
}

#Preview {
    SwiftUIView()
}

这两种方案都能在初始路径返回、手动导航等所有场景下，准确追踪当前显示的屏幕，完全不受onAppear的触发限制影响。

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