SwiftUI中NavigationStack跳转后自动返回主页问题排查

这种情况大多是NavigationStack的路径绑定错误或者navigationDestination使用位置不对导致的，给你整理了核心修复点和代码示例：

常见问题原因 #

• 用了临时变量而非@State/@Binding绑定导航路径：视图刷新时路径会被重置，导致跳转后立刻回退
• navigationDestination修饰符放错位置：必须放在NavigationStack包含的子视图（比如List）上，而非NavigationStack本身外面
• 点击事件没有正确更新导航路径：比如忘记给path append对应的值

修正后的代码示例 #

HomeView.swift

import SwiftUI

struct HomeView: View {
    // 必须用@State绑定导航路径，确保状态能被正确维护
    @State private var navigationPath = NavigationPath()
    let items = ["Item 1", "Item 2", "Item 3"]
    
    var body: some View {
        NavigationStack(path: $navigationPath) {
            List(items, id: \.self) { item in
                // 点击按钮更新导航路径
                Button(item) {
                    navigationPath.append(item)
                }
            }
            .navigationTitle("Home")
            // 绑定对应类型的导航目标，和path中append的类型一致
            .navigationDestination(for: String.self) { selectedItem in
                DetailView(selectedItem: selectedItem)
            }
        }
    }
}

DetailView.swift

import SwiftUI

struct DetailView: View {
    let selectedItem: String
    
    var body: some View {
        Text("详情页面：\(selectedItem)")
            .navigationTitle(selectedItem)
    }
}

额外注意事项 #

• 如果用自定义数据类型作为路由（比如自定义模型），要确保该类型实现了Hashable协议
• 不要混用手动更新path和NavigationLink的destination参数，避免状态冲突
• 确保navigationDestination的for参数类型和你append到path里的类型完全匹配，否则导航目标不会被触发

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