SwiftUI导航栏标题与导航项仅预览可见，模拟器不显示求助

核心问题原因 #

• 新旧导航组件冲突：同时使用iOS 16+的NavigationStack和旧版NavigationView，嵌套导致导航栏渲染异常，这是预览正常但真机/模拟器不显示的关键原因。
• 导航修饰符位置错误：navigationBarTitle和navigationBarItems被添加到NavigationStack外部，而非内部根视图，SwiftUI无法正确识别这些配置。
• 无效的导航栏设置：SideMenuView上的navigationBarBackButtonHidden无意义，应在根视图统一控制。

修复后的主页面代码 #

import SwiftUI
import MapKit

struct MainPageView: View {
    @State var showMenu = false
    @State var path = NavigationPath()

    var body: some View {
        if UserDefaults.standard.value(forKey: "login") == nil {
            LoginView()
        } else {
            NavigationStack(path: $path) {
                GeometryReader { geometry in
                    ZStack(alignment: .leading) {
                        MainPage()
                            .frame(width: geometry.size.width, height: geometry.size.height)
                            .offset(x: showMenu ? geometry.size.width / 2 : 0)
                            .disabled(showMenu)
                            // 将导航栏配置移到根视图层级
                            .navigationBarTitle("Coonecta Client", displayMode: .inline)
                            .navigationBarItems(leading: NavItems(showMenu: $showMenu))
                            .navigationBarBackButtonHidden(true)

                        if showMenu {
                            SideMenuView()
                                .frame(width: geometry.size.width / 1.4)
                                .transition(.move(edge: .leading))
                        }
                    }
                }
                .gesture(
                    DragGesture()
                        .onEnded { gesture in
                            if gesture.translation.width < -100 {
                                withAnimation {
                                    showMenu = false
                                }
                            }
                        }
                )
                .onAppear {
                    showMenu = false
                }
                .navigationDestination(for: String.self) { view in
                    if view == "LoginView" {
                        LoginView()
                            .navigationBarBackButtonHidden(true)
                    }
                }
            }
            .background(Color.clear)
        }
    }
}

struct NavItems : View{
    @Binding var showMenu: Bool

    var body: some View{
        Button(action: {
            withAnimation{
                showMenu.toggle()
            }
        }) {
            Image(systemName: "line.horizontal.3")
                .imageScale(.large)
                .foregroundColor(.gray)
        }
    }
}

struct MainPage: View {
    var body: some View {
        MapContainerView()
    }
}

struct MainPage_Previews: PreviewProvider {
    static var previews: some View {
        NavigationStack {
            MainPageView()
                .environmentObject(LoginSettings())
                .environmentObject(SideMenuSettings())
        }
    }
}

关键修复点说明 #

1. 移除冗余的NavigationView：仅保留NavigationStack，避免新旧导航组件冲突。
2. 调整导航修饰符位置：将导航栏相关配置直接绑定到MainPage所在视图，确保SwiftUI正确渲染导航栏。
3. 简化手势逻辑：移除无用的onChanged闭包，优化代码可读性。
4. 统一预览环境：预览改用NavigationStack，保持与真机/模拟器一致的渲染逻辑，避免之前出现的按钮重复Bug。

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