SwiftUI iOS16+ 替换原生返回按钮图标并保留原生功能的实现疑问

我太懂你的需求了——想把原生返回按钮的图标换成自己的，但又不想丢掉iOS自带的滑动返回、自动适配导航栈这些原生功能，毕竟自定义按钮还要额外处理手势逻辑，实在太麻烦了对吧？

你之前尝试的.navigationBarBackButtonHidden() .toolbarRole(.editor)只能去掉返回按钮的文字，没法替换图标；而且如果隐藏原生按钮后自己加自定义按钮，还可能丢失系统默认的滑动返回手势（虽然部分场景下手势还能用，但总归不是原生的完整体验）。

给你一个完美适配iOS16+的方案，完全保留所有原生功能，只需要简单几步：

方法：通过UIKit外观全局替换返回按钮图标 #

我们可以利用UIKit的UINavigationBar外观设置，直接替换系统返回按钮的图标，这样整个应用里的原生返回按钮都会自动换成你的自定义图标，而且所有原生功能（滑动返回、导航栈逻辑、自动显示/隐藏）都不受影响。

代码示例：

// 可以放在你的App入口的init里，或者某个基础视图的onAppear中
init() {
    // 加载你的自定义返回图标，注意设置withRenderingMode确保图标显示正确
    guard let backIcon = UIImage(named: "icon_back")?.withRenderingMode(.alwaysOriginal) else { return }
    // 设置导航栏的返回指示器图标和过渡遮罩图
    UINavigationBar.appearance().backIndicatorImage = backIcon
    UINavigationBar.appearance().backIndicatorTransitionMaskImage = backIcon
}

额外：去掉返回按钮的文字 #

如果还想去掉返回按钮旁边的文字（比如上一页的标题），可以在你的NavigationStack所在的视图里加上：

.toolbarRole(.editor)

这是iOS16+专门用来隐藏返回按钮文字的优雅方式，比手动设置空标题更稳妥。

为什么这个方法更好？ #

• 完全保留原生滑动返回手势，不需要额外写任何手势处理代码
• 自动适配导航栈的逻辑，系统会自动处理按钮的显示/隐藏
• 全局设置一次，所有页面的返回按钮都会生效（如果只想在特定页面生效，可以在视图的onAppear设置，onDisappear恢复默认）

如果你只想在某个特定页面替换返回按钮图标，可以这样做：

struct YourView: View {
    // 保存默认的返回图标，用于离开页面时恢复
    @State private var defaultBackImage: UIImage?
    @State private var defaultBackMaskImage: UIImage?
    
    var body: some View {
        NavigationStack {
            // 你的视图内容
        }
        .onAppear {
            // 保存默认图标
            defaultBackImage = UINavigationBar.appearance().backIndicatorImage
            defaultBackMaskImage = UINavigationBar.appearance().backIndicatorTransitionMaskImage
            // 设置自定义图标
            guard let backIcon = UIImage(named: "icon_back")?.withRenderingMode(.alwaysOriginal) else { return }
            UINavigationBar.appearance().backIndicatorImage = backIcon
            UINavigationBar.appearance().backIndicatorTransitionMaskImage = backIcon
        }
        .onDisappear {
            // 恢复默认图标
            UINavigationBar.appearance().backIndicatorImage = defaultBackImage
            UINavigationBar.appearance().backIndicatorTransitionMaskImage = defaultBackMaskImage
        }
    }
}

这样就可以完美实现你想要的效果啦，既替换了图标，又完全保留了iOS原生的所有返回相关功能~

备注：内容来源于stack exchange，提问作者Punit