如何全局覆盖NavigationView默认返回按钮无需逐视图添加修饰符

不存在完全零配置、无需任何额外代码就能替换系统默认返回按钮的原生方案，但有几种实现方式可以把重复逻辑收拢到全局，不需要给每个二级视图单独编写自定义返回按钮的代码，维护成本极低。

方案1：UIAppearance全局样式替换（仅改外观，保留系统默认交互） #

如果你的需求只是修改返回按钮的图标、颜色、隐藏返回文字，不需要改变点击返回的逻辑，直接在App启动时执行一次UIAppearance配置即可，对所有导航栈内的页面全局生效，不需要给任何SwiftUI页面加单独修饰符：

// 写在@main入口的init方法里，应用启动时执行一次即可
init() {
    let navAppearance = UINavigationBarAppearance()
    // 替换返回箭头图标
    navAppearance.setBackIndicatorImage(
        UIImage(systemName: "chevron.backward"),
        transitionMaskImage: UIImage(systemName: "chevron.backward")
    )
    // 隐藏返回按钮自带的上一页标题文字
    navAppearance.backButtonAppearance.normal.titleTextAttributes = [.foregroundColor: UIColor.clear]
    // 统一设置返回按钮的颜色
    navAppearance.backButtonAppearance.normal.tintColor = .label
    
    // 将配置应用到所有状态下的导航栏
    UINavigationBar.appearance().standardAppearance = navAppearance
    UINavigationBar.appearance().scrollEdgeAppearance = navAppearance
    UINavigationBar.appearance().compactAppearance = navAppearance
}

注意：这个方案无法修改返回按钮的点击逻辑，点击后依然执行系统默认的返回操作，如果需要在返回前加弹窗、埋点、自定义路由逻辑，这个方案不适用。

方案2：封装统一扩展+自定义导航容器（支持自定义交互） #

如果需要自定义返回按钮的点击行为，可以把重复逻辑收拢到两处，业务页面完全不需要写重复代码：

1. 先封装一个View扩展，把隐藏默认按钮、添加自定义返回按钮的逻辑打包

extension View {
    func applyGlobalBackButton() -> some View {
        self
            .navigationBarBackButtonHidden(true)
            .toolbar {
                ToolbarItem(placement: .navigationBarLeading) {
                    Button {
                        // 在这里写全局统一的返回逻辑，比如埋点、返回前校验、路由跳转
                        guard let keyWindow = UIApplication.shared.connectedScenes
                            .compactMap({ $0 as? UIWindowScene })
                            .flatMap({ $0.windows })
                            .first(where: \.isKeyWindow),
                              let navController = keyWindow.rootViewController as? UINavigationController else {
                            return
                        }
                        navController.popViewController(animated: true)
                    } label: {
                        // 在这里统一配置自定义返回按钮的样式
                        Image(systemName: "chevron.backward")
                            .foregroundColor(.primary)
                    }
                }
            }
    }
}

2. 封装一个项目全局使用的自定义导航容器，所有页面跳转都通过这个容器管理，自动给所有推入导航栈的二级页面加上applyGlobalBackButton()修饰符，业务开发时完全不需要关心返回按钮的配置，正常写页面跳转即可。
   如果是用UIKit的UINavigationController封装导航容器，甚至可以直接在导航控制器的代理里拦截所有push操作，给推入的页面统一替换返回按钮，SwiftUI层完全不需要加任何修饰符。

方案3：iOS16+ NavigationStack全局Toolbar配置 #

如果项目最低支持版本是iOS16，可以直接使用SwiftUI新版的NavigationStack，在根导航栈上统一配置Toolbar项，所有子页面会默认继承根视图的Toolbar配置，配合全局隐藏默认返回按钮的设置，就可以实现自定义返回按钮全局生效，不需要逐页配置。

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            NavigationStack {
                RootPage()
                    .navigationBarBackButtonHidden(true)
                    .toolbar {
                        ToolbarItem(placement: .navigationBarLeading) {
                            // 自定义的全局返回按钮
                            GlobalBackButton()
                        }
                    }
            }
        }
    }
}

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