SwiftUI中NavigationLink无法跳转至FavouritesView新视图如何解决

架构老林

2026-8-30

NavigationLink点击无法跳转至FavouritesView修复方案

故障根因

NavigationLink本身不具备独立的导航跳转能力，必须依赖父层级的导航容器才能触发跳转，你当前代码的核心问题是承载HomeView的视图层级没有包裹导航容器，这是SwiftUI导航最常见的失效原因。
如果已经配置了导航容器仍无响应，大概率是以下两个问题：

NavigationLink放在Text的overlay中时，点击区域被上层其他视图遮挡
父级视图设置了allowsHitTesting(false)，阻断了点击事件传递

修复步骤

为视图层级添加导航容器
iOS 16及以上版本使用NavigationStack，需要兼容低版本则使用NavigationView，在HomeView的最外层或者页面入口处包裹即可：
```
// App入口或者HomeView根节点包裹
NavigationStack {
    HomeView()
}
```

调整导航按钮放置位置（推荐）
不要将导航按钮放在Text的overlay中，使用SwiftUI官方提供的toolbar修饰符将按钮放在导航栏右上角位置，不会出现点击区域异常的问题，修正后的代码参考：

var body: some View {
    // 根节点已经在外层包裹NavigationStack的话这里不需要重复加
    VStack(spacing: 0) {
        Text("test")
            .font(.title.bold())
            .frame(maxWidth: .infinity)
            .padding(.bottom, 10)
        // 保留你原有的VStack内其他内容
    }
    .toolbar {
        ToolbarItem(placement: .navigationBarTrailing) {
            NavigationLink {
                FavouritesView()
            } label: {
                Image(systemName: "doc.badge.gearshape")
                    .font(.title3)
                    .foregroundColor(.white)
            }
        }
    }
}