Xcode 11.1编译后UISearchBar显示异常，如何恢复原设计？

刚好我之前也碰到过这个版本差异的布局坑，给你详细拆解下原因和解决方案：

问题产生的原因 #

这个异常是苹果的预期行为，根源在于Xcode 11.1对应的iOS 13 SDK更新了UINavigationBar的布局计算逻辑：

• 在Xcode 11.0中，通过Storyboard把UISearchBar放在导航栏下方时，系统会沿用旧的约束逻辑，让搜索栏直接紧贴导航栏底部；
• 从Xcode 11.1开始，苹果优化了导航区域的布局规范，尤其是当导航栏使用大标题、或者依赖安全区域自动布局时，系统会给导航栏下方的视图自动添加额外的顶部间距，导致搜索栏被向下偏移，出现显示异常。

还原原设计效果的修复方案 #

如果你想保留Xcode 11.0里的显示效果，这里有几个靠谱的办法：

方法1：手动添加精准布局约束（最稳妥） #

放弃Storyboard里的自动布局，用代码给搜索栏绑定固定约束，彻底避免版本差异影响：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 假设searchBar已经通过IBOutlet和Storyboard关联
    searchBar.translatesAutoresizingMaskIntoConstraints = false
    
    NSLayoutConstraint.activate([
        // 绑定到安全区域顶部，也就是导航栏的底部
        searchBar.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
        searchBar.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        searchBar.trailingAnchor.constraint(equalTo: view.trailingAnchor)
    ])
}

这种方式完全不受系统布局逻辑更新的影响，能稳定实现搜索栏紧贴导航栏的效果。

方法2：调整导航栏的布局属性（仅适用于大标题场景） #

如果你的页面用了导航栏大标题，可以关闭大标题的自动调整，或者重置导航栏的布局边距：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    
    // 关闭大标题（如果不需要的话）
    navigationController?.navigationBar.prefersLargeTitles = false
    // 重置导航栏布局边距，消除额外间距
    navigationController?.navigationBar.layoutMargins = UIEdgeInsets.zero
}

注意这个方法只对使用大标题的页面有效，普通标题场景可能起不到作用。

方法3：改用UISearchController嵌入导航栏（官方推荐） #

苹果在iOS 13之后更推荐把搜索栏作为UISearchController的一部分嵌入导航栏，这种方式会自动适配所有Xcode版本的布局规则：

override func viewDidLoad() {
    super.viewDidLoad()
    
    let searchController = UISearchController(searchResultsController: nil)
    // 把搜索控制器绑定到导航项
    navigationItem.searchController = searchController
    // 设置为始终显示搜索栏，不随滚动隐藏
    navigationItem.hidesSearchBarWhenScrolling = false
}

这种方式不仅能完美解决版本兼容问题，还符合苹果的设计规范，后续也不会再有类似的布局异常。

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