Xcode SwiftUI导航栏leading navigationBarItem不显示trailing正常如何解决

问题原因 #

这个问题是SwiftUI旧版导航栏API的已知兼容性问题，核心原因有两个：

1. 你使用的navigationBarItems是苹果在iOS 15.4就标记为废弃的旧API，仅兼容iOS 13-15.4，该API在多页面导航栈下和navigationBarBackButtonHidden搭配使用时，leading位置的自定义元素经常出现渲染异常：即使你设置了隐藏系统返回按钮，系统仍会在leading位置保留不可见的返回按钮布局占位，导致你添加的自定义按钮被挤出可视区域，而trailing位置没有系统默认占位，所以不会出现该问题。
2. 如果你在iPad、大屏iPhone横屏等场景下运行，默认NavigationView会采用分栏样式，次级页面的leading位置按钮会被折叠到侧边栏触发按钮中，也会导致看起来没有显示。

解决方法 #

方案1：使用新版toolbar API（推荐，适配iOS 14及以上） #

苹果从iOS 14开始推出toolbar修饰符替代旧的navigationBarItems，是当前官方推荐的导航栏元素配置方式，不存在位置渲染异常的问题，修改后的ThirdView代码如下：

struct ThirdView: View {
    @Binding var thirdViewActive: Bool
    var body: some View {
        VStack(spacing: 15) {
            Text("Third View")
            Spacer()
        }.padding()
        .navigationBarBackButtonHidden(true)
        // 替换为toolbar配置
        .toolbar {
            ToolbarItem(placement: .navigationBarLeading) {
                Button("Back to 2nd View") {
                    thirdViewActive = false
                }
            }
        }
    }
}

如果是在大屏设备上运行，建议同时给ContentView的NavigationView指定栈式样式，避免分栏模式的影响：

NavigationView {
    // 原有ContentView内容
}
.navigationViewStyle(.stack)

方案2：兼容iOS 13的临时修复 #

如果你的项目需要支持iOS 13，无法使用新版toolbarAPI，可以给leading按钮嵌套HStack强制清除系统占位的影响：

.navigationBarItems(leading:
    HStack(spacing: 0) {
        Button("Back to 2nd View") {
            thirdViewActive = false
        }
        Spacer()
    }
)

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