SwiftUI视图嵌入UIHostingVC后导航栏大标题无法转内联等问题

问题根源 #

SwiftUI的UIHostingController会默认隔离内部滚动视图（对应List）与外部UIKit导航控制器的交互，导致导航栏无法感知List的滚动状态，从而无法触发大标题切换和毛玻璃背景的默认行为。

分步解决方案 #

1. 配置导航栏基础样式 #

在FriendsViewController的viewDidLoad中设置大标题模式和导航栏外观：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 启用大标题并设置显示模式
    navigationItem.largeTitleDisplayMode = .automatic
    navigationController?.navigationBar.prefersLargeTitles = true
    
    // 配置滚动前后的导航栏外观
    let scrollEdgeAppearance = UINavigationBarAppearance()
    scrollEdgeAppearance.configureWithTransparentBackground() // 顶部滚动位置时透明
    let standardAppearance = UINavigationBarAppearance()
    standardAppearance.configureWithDefaultBackground() // 滚动后显示毛玻璃背景
    
    navigationController?.navigationBar.scrollEdgeAppearance = scrollEdgeAppearance
    navigationController?.navigationBar.standardAppearance = standardAppearance
    navigationController?.navigationBar.compactAppearance = standardAppearance
}

2. 关联SwiftUI List的滚动视图与导航栏 #

在FriendsViewController中，找到UIHostingController内部的UIScrollView（对应SwiftUI List），并让导航栏跟踪其滚动状态：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    
    guard let hostingScrollView = findScrollView(in: hostingController.view) else { return }
    
    // 确保内容适配安全区域
    hostingScrollView.contentInsetAdjustmentBehavior = .automatic
    // 绑定滚动视图代理，让导航栏感知滚动
    hostingScrollView.delegate = self
}

// 递归查找子视图中的UIScrollView
private func findScrollView(in view: UIView) -> UIScrollView? {
    if let scrollView = view as? UIScrollView {
        return scrollView
    }
    for subview in view.subviews {
        if let scrollView = findScrollView(in: subview) {
            return scrollView
        }
    }
    return nil
}

让FriendsViewController遵守UIScrollViewDelegate，触发导航栏布局更新：

extension FriendsViewController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        navigationController?.navigationBar.layoutIfNeeded()
    }
}

3. SwiftUI视图的注意事项 #

确保SwiftUI List没有干扰安全区域的设置：

struct FriendsListView: View {
    var body: some View {
        List(0..<20) { index in
            Text("好友 \(index)")
        }
        // 不要添加edgesIgnoringSafeArea(.top)，避免破坏导航栏交互
    }
}

说明 #

通过手动关联SwiftUI List对应的滚动视图与UIKit导航栏，让导航控制器能正确感知滚动状态，从而还原UIKit默认的大标题切换和毛玻璃背景变化逻辑。

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