SwiftUI自定义导航栏搭配TabView时侧滑返回手势冲突如何解决

PageTabViewStyle 风格的 TabView 本质基于 UIScrollView 实现，它的水平滑动手势和系统导航的侧滑返回（interactivePopGestureRecognizer）手势优先级冲突，系统默认优先响应 TabView 的滚动手势，就会导致侧滑返回失效。以下是两种可行的解决方案：

方案1：调整手势优先级（无侵入，推荐） #

只需修改你原本实现侧滑返回的 UINavigationController 扩展，增加手势优先级判断逻辑，让侧滑返回手势优先于 TabView 内部的滚动手势响应即可，不需要改动任何 TabView 相关代码，也不影响 TabView 内容占满屏幕的需求：

extension UINavigationController: UIGestureRecognizerDelegate {
    override open func viewDidLoad() {
        super.viewDidLoad()
        interactivePopGestureRecognizer?.delegate = self
    }
    
    public func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        return viewControllers.count > 1
    }
    
    // 新增：设置侧滑返回手势优先级高于ScrollView的滑动手势
    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        guard gestureRecognizer == interactivePopGestureRecognizer else {
            return false
        }
        // 判断另一个手势是否是TabView内部的滚动视图手势
        return otherGestureRecognizer.view is UIScrollView
    }
}

修改后系统会自动判断滑动场景：

• 用户从屏幕左边缘向右滑，优先触发侧滑返回上一级页面
• 其他位置的水平滑动，正常触发 TabView 的页面切换逻辑

方案2：按需禁用TabView滑动（可选） #

如果你只需要在TabView处于第一个标签页时支持侧滑返回，也可以通过绑定TabView的选中索引，动态控制TabView的滑动状态：

struct SecondView: View {
    @Environment(\.presentationMode) var presentationMode
    // 记录当前选中的Tab索引
    @State private var currentTab = 1
    
    var body: some View {
        VStack(alignment: .leading) {
            Image(systemName: "chevron.left")
                .foregroundColor(Color(.systemBlue))
                .font(.title2)
                .onTapGesture {
                    self.presentationMode.wrappedValue.dismiss()
                }
                .padding()
            TabView(selection: $currentTab) {
                Text("Test 1")
                    .tag(1)
                Text("Test 2")
                    .tag(2)
                Text("Test 3")
                    .tag(3)
            }
            .tabViewStyle(PageTabViewStyle(indexDisplayMode: .never))
            // 只有不是第一个标签页的时候才允许TabView滑动
            .disabled(currentTab == 1)
        }
        .background(Color(.systemGray6))
        .navigationBarHidden(true)
    }
}

该方案逻辑简单，但缺点是在第一个标签页时，除了左边缘侧滑，其他位置的右滑也无法切换到第二个标签页，适合不需要频繁在第一个和第二个标签页之间滑动的场景。

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