UISearchController搜索栏未显示问题求助（附代码）

问题描述 #

我正在通过教程学习UISearchController组件，但遇到了UISearchBar未显示的问题。以下是我的实现代码：

let searchController = UISearchController(searchResultsController: nil)
override func viewDidLoad() {
    super.viewDidLoad()
    searchController.searchResultsUpdater = self
    searchController.obscuresBackgroundDuringPresentation = false
    searchController.searchBar.placeholder = "Search Candies"
    navigationItem.searchController = searchController
    definesPresentationContext = true
}

当前应用显示不符合预期，请问该如何修复此问题？

修复方案与排查步骤 #

我来帮你梳理几个最常见的导致UISearchBar不显示的原因，按优先级排查：

1. 确认视图控制器已嵌入导航控制器 #

navigationItem.searchController 这个API的前提是你的视图控制器必须是UINavigationController的子控制器——搜索栏是挂载在导航栏上的，如果没有导航栏，自然没地方显示。

• 解决方法：
  • 如果用Storyboard：选中你的视图控制器，右键选择「Embed In」→「Navigation Controller」；
  • 如果用代码初始化：

    let yourVC = YourViewController()
    let navController = UINavigationController(rootViewController: yourVC)
    // 将导航控制器设置为根控制器
    UIApplication.shared.windows.first?.rootViewController = navController
    

2. 检查导航栏是否被隐藏 #

如果导航栏被主动隐藏了，搜索栏也会跟着消失。可以在viewDidLoad里添加确认代码：

// 确保导航栏处于显示状态
navigationController?.isNavigationBarHidden = false

也可以在Storyboard中检查导航控制器的「Shows Navigation Bar」选项是否被勾选。

3. 确认iOS版本兼容性 #

navigationItem.searchController是iOS 11才新增的属性，如果你的项目部署目标低于iOS 11，这个写法完全不会生效。

• 解决方法：
  • 升级项目部署目标到iOS 11及以上（推荐，毕竟现在iOS 16+是主流）；
  • 如果需要兼容iOS 10及以下，改用老的集成方式：把搜索栏添加到表视图的头部或者导航栏的标题视图中：

    // 兼容低版本的写法：添加到表视图头部
    tableView.tableHeaderView = searchController.searchBar
    

4. 验证definesPresentationContext的有效性 #

你已经设置了definesPresentationContext = true，但要确保这个属性没有被后续代码覆盖，或者设置时机正确（必须在viewDidLoad或更早的生命周期方法中设置）。这个属性用于确保搜索控制器的展示上下文正确，设置错误也可能导致搜索栏不显示。

5. 检查搜索控制器的作用域 #

你的代码里已经把searchController声明为实例变量，这没问题，但如果不小心写成了局部变量（比如在viewDidLoad内部声明），控制器会被提前释放，导致搜索栏无法显示。确认变量声明在类的顶层即可。

建议先从「是否嵌入导航控制器」开始排查，这是新手遇到这个问题最常见的原因！

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