SwiftUI NavigationView在iPad仅显示于侧边栏问题求助

问题分析 #

iPad端的NavigationView默认采用双栏布局（侧边栏+详情区），当根视图没有明确的导航层级结构时，系统会自动将内容放入侧边栏，导致需要点击返回按钮才会正常显示。即便添加.navigationViewStyle(.stack)，若视图结构存在问题，也可能无法生效。

修复方案 #

方案1：调整NavigationView结构，明确单栏布局 #

给根视图补充明确的层级提示，强制系统采用单栏布局：

var body: some View {
    NavigationView {
        ZStack {
            // 你的原有内容
        }
        .navigationBarTitleDisplayMode(.inline)
        .toolbar {
            ToolbarItem(placement: .principal) {
                VStack {
                    Text("Add Light to Your Journey")
                        .font(Font.custom("EduTASBeginner-Regular", size: 24))
                    // ... 其他内容
                }
            }
        }
        // 通过空标题或占位，让系统识别为主内容视图
        .navigationTitle("")
    }
    // 强制全局使用栈式布局，对齐iPhone端表现
    .navigationViewStyle(StackNavigationViewStyle())
}

方案2：升级使用NavigationStack（iOS 16+） #

如果应用支持iOS 16及以上版本，推荐直接替换为新的NavigationStack，它在iPad和iPhone上的布局行为更统一，无需额外处理样式：

var body: some View {
    NavigationStack {
        ZStack {
            // 你的原有内容
        }
        .navigationBarTitleDisplayMode(.inline)
        .toolbar {
            ToolbarItem(placement: .principal) {
                VStack {
                    Text("Add Light to Your Journey")
                        .font(Font.custom("EduTASBeginner-Regular", size: 24))
                    // ... 其他内容
                }
            }
        }
    }
}

方案3：排查层级冲突 #

检查视图结构中是否存在嵌套的NavigationView，或者未清理的导航栈状态。确保整个层级中只有一个导航容器（NavigationView/NavigationStack），避免布局逻辑冲突。

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