如何在UINavigationController中重写返回滑动手势以回到根视图控制器

Hey，这个需求其实挺常见的——想把系统默认的滑动返回手势改成直接回到根视图控制器对吧？我来给你分UIKit和SwiftUI两种主流场景，讲清楚具体怎么实现：

一、UIKit 解决方案 #

不管你是用系统的UINavigationController还是自定义的导航子类，核心思路都是拦截系统自带的滑动返回手势，替换成我们自己的处理逻辑。

步骤1：获取并修改系统滑动手势 #

首先拿到导航控制器的interactivePopGestureRecognizer，移除它默认的响应方法，然后绑定我们自己的处理函数：

Swift 代码示例

// 在你的ViewController里（或者自定义NavigationController子类中）
override func viewDidLoad() {
    super.viewDidLoad()
    
    // 获取系统滑动手势
    guard let interactivePopGesture = navigationController?.interactivePopGestureRecognizer else {
        return
    }
    
    // 移除默认的target-action
    interactivePopGesture.removeTarget(nil, action: nil)
    // 添加自定义处理方法
    interactivePopGesture.addTarget(self, action: #selector(handleCustomSwipeBack))
}

Objective-C 代码示例

- (void)viewDidLoad {
    [super viewDidLoad];
    
    // 获取系统滑动手势
    UIGestureRecognizer *interactivePopGesture = self.navigationController.interactivePopGestureRecognizer;
    if (!interactivePopGesture) return;
    
    // 移除默认的target-action
    [interactivePopGesture removeTarget:nil action:NULL];
    // 添加自定义处理方法
    [interactivePopGesture addTarget:self action:@selector(handleCustomSwipeBack)];
}

步骤2：实现自定义滑动处理逻辑 #

接下来写我们的手势响应方法，直接调用popToRootViewController，一定要加判断避免崩溃：

Swift 代码示例

@objc private func handleCustomSwipeBack() {
    // 确保导航栈里至少有2个VC，才执行pop到根的操作
    guard let navController = navigationController, navController.viewControllers.count > 1 else {
        return
    }
    
    navController.popToRootViewController(animated: true)
}

Objective-C 代码示例

- (void)handleCustomSwipeBack {
    // 确保导航栈里至少有2个VC，才执行pop到根的操作
    if (self.navigationController.viewControllers.count <= 1) {
        return;
    }
    
    [self.navigationController popToRootViewControllerAnimated:YES];
}

二、SwiftUI 解决方案 #

SwiftUI的NavigationStack（或者旧版的NavigationView）默认的滑动返回逻辑也是回到上一页，要修改的话，我们可以通过UIViewControllerRepresentable包装系统的UINavigationController，然后复用上面UIKit的逻辑：

自定义导航控制器包装器 #

struct CustomRootNavigationController: UIViewControllerRepresentable {
    // 传入你的根视图
    let rootView: any View
    
    func makeUIViewController(context: Context) -> UINavigationController {
        // 将SwiftUI视图包装成UIKit的ViewController
        let hostingVC = UIHostingController(rootView: rootView)
        let navController = UINavigationController(rootViewController: hostingVC)
        
        // 拦截系统滑动手势
        if let interactivePopGesture = navController.interactivePopGestureRecognizer {
            interactivePopGesture.removeTarget(nil, action: nil)
            interactivePopGesture.addTarget(context.coordinator, action: #selector(context.coordinator.handleSwipeBack))
        }
        
        navController.delegate = context.coordinator
        return navController
    }
    
    func updateUIViewController(_ uiViewController: UINavigationController, context: Context) {}
    
    // 创建Coordinator来处理手势和代理逻辑
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, UINavigationControllerDelegate {
        let parent: CustomRootNavigationController
        
        init(_ parent: CustomRootNavigationController) {
            self.parent = parent
        }
        
        @objc func handleSwipeBack() {
            guard let navController = parent.makeUIViewController(context: Context()).interactivePopGestureRecognizer?.view?.next as? UINavigationController else {
                return
            }
            
            // 同样要加判断避免崩溃
            if navController.viewControllers.count > 1 {
                navController.popToRootViewController(animated: true)
            }
        }
    }
}

在App中使用这个包装器 #

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            // 用自定义导航控制器包装你的根视图
            CustomRootNavigationController(rootView: ContentView())
        }
    }
}

额外提醒 #

• 如果你的项目用了第三方导航库（比如FDFullscreenPopGesture），思路是一样的：找到对应的手势对象，替换它的响应逻辑即可。
• 如果你不想完全替换系统手势，而是想在某些特定页面才触发回到根VC的逻辑，可以在handleCustomSwipeBack里加页面判断，比如检查当前VC的类型，再决定是pop到根还是pop上一页。

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