SwiftUI NavigationView iPad竖屏模式下返回按钮不显示问题

该问题和业务视图、NSViewRepresentable包装的图表组件无关，是多平台应用的跨平台导航栏默认配置冲突导致的：

• 纯iOS项目的NavigationView默认走UIKit导航栏渲染逻辑，iPad竖屏双列导航自动折叠时，系统会自动渲染带可见图标的侧边栏返回按钮
• 同时支持iOS、macOS的多平台应用，导航栏需要兼容AppKit与UIKit两套渲染逻辑，在iOS端运行时会默认继承macOS端的侧边栏按钮配置：按钮的点击响应、触发热区均正常注册，但按钮图标要么被设为透明，要么tint色和导航栏背景色完全一致，最终出现点击对应区域能正常唤出左侧面板、但按钮本身不可见的现象。

可以通过两个快速测试确认根因：

• 移除多平台Target的macOS支持，仅保留iOS平台，重新运行后返回按钮会和纯iOS测试项目表现一致，正常显示
• 保持多平台配置，给导航栏全局设置一个和背景色差异明显的tint色，若按钮出现即可确认是颜色配置问题

不需要调整现有双列NavigationView的结构，二选一即可解决：

1. 全局配置iOS端导航栏外观
   在应用入口处添加全局外观配置，强制iOS端导航栏按钮使用可见的tint色：

@main
struct YourApp: App {
    init() {
        #if os(iOS)
        UINavigationBar.appearance().tintColor = .systemBlue
        #endif
    }
    var body: some Scene {
        WindowGroup {
            // 你的原有NavigationView代码
        }
    }
}

2. 显式添加侧边栏触发按钮
   如果全局配置不生效，可以在右侧主视图的工具栏中显式放置侧边栏按钮，覆盖系统默认的不可见按钮：

NavigationView {
    Text("This is the left side")
    Text("This is the right side")
        .toolbar {
            ToolbarItem(placement: .navigationBarLeading) {
                Button {
                    #if os(iOS)
                    let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene
                    windowScene?.keyWindow?.rootViewController?.navigationController?.toggleSidebar(nil)
                    #endif
                } label: {
                    Image(systemName: "sidebar.left")
                }
            }
        }
}
.navigationViewStyle(.columns)

补充：如果你的应用最低支持iOS 16+，建议直接替换为NavigationStack+NavigationSplitView的组合，多平台适配的一致性远高于旧版NavigationView，可以自动规避这类跨平台样式冲突问题。

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