SwiftUI中NavigationLink点击无响应、加NavigationView后仅局部跳转如何解决

AI 小北

2026-10-6

问题原因

你遇到的异常都是NavigationView的嵌套位置错误导致的：

NavigationLink必须在同一个NavigationView/NavigationStack的作用域内才能触发跳转，最初没有添加NavigationView所以点击无任何响应
后续将NavigationView嵌套在HStack的局部区域后，每个独立的NavigationView的导航栈作用域仅限自身的frame范围，所以点击跳转只会在这个小区域内渲染新页面；同时iOS默认NavigationView在横向布局下采用侧边栏样式，因此会占据半屏宽度。

解决方法

将NavigationView移到当前页面的根视图外层，不要嵌套在局部容器中，HStack内仅保留NavigationLink即可，参考实现代码如下：

struct YourPageView: View {
    // 替换为你自身的scoreTracker定义
    @Binding var scoreTracker: Int
    
    var body: some View {
        // NavigationView套在当前页面的最外层
        NavigationView {
            VStack {
                // 原有头部工具栏HStack
                HStack {
                    Image(systemName: "arrow.counterclockwise")
                    Spacer()
                    NavigationLink(destination: scoreView(scoreTracker: $scoreTracker)) {
                        Image(systemName: "list.bullet")
                    }
                }
                .padding(.horizontal)
                
                // 页面其他原有内容
                Spacer()
            }
            // 可选：如果当前页面不需要显示导航栏，添加这行隐藏避免多余占位
            .navigationBarHidden(true)
        }
    }
}

// 你的目标跳转页面
struct scoreView: View {
    @Binding var scoreTracker: Int
    var body: some View {
        // 页面自身实现
        Text("当前分数：\(scoreTracker)")
    }
}