代码创建SearchBar后，禁用滚动隐藏功能失效的解决指引

首先，咱们得先明确你是把SearchBar直接作为子视图使用，还是配合UISearchController实现的？不同的实现方式，对应的禁用滚动隐藏的处理逻辑不一样，我给你梳理两种最常见的场景：

场景1：使用UISearchController（现代推荐方案） #

如果是用UISearchController嵌入导航栏或TableView的headerView，要禁用滚动时隐藏，需要设置两个关键属性：

// 初始化搜索控制器
let searchController = UISearchController(searchResultsController: nil)
// 禁止搜索栏在展示时隐藏导航栏
searchController.hidesNavigationBarDuringPresentation = false
// 关闭背景模糊（避免干扰滚动时的视图展示）
searchController.obscuresBackgroundDuringPresentation = false

// iOS 11+ 推荐直接把搜索控制器绑定到导航栏
navigationItem.searchController = searchController
// 核心：强制导航栏上的搜索栏不随滚动隐藏
navigationItem.hidesSearchBarWhenScrolling = false

这里要重点注意navigationItem.hidesSearchBarWhenScrolling这个属性，它是iOS 11之后专门用来控制导航栏搜索栏滚动隐藏的开关，优先级很高，一定要设为false。

场景2：直接创建UISearchBar作为TableView的headerView #

如果是直接把SearchBar添加到UITableView的tableHeaderView，滚动时“隐藏”往往是因为headerView高度没有固定，被自动压缩导致的，你可以这样处理：

// 创建SearchBar
let searchBar = UISearchBar()
searchBar.placeholder = "请输入搜索内容"
// 先将SearchBar设为tableHeaderView
tableView.tableHeaderView = searchBar
// 强制固定headerView的高度，避免滚动时被压缩
if let headerView = tableView.tableHeaderView {
    let fitHeight = headerView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize).height
    var headerFrame = headerView.frame
    headerFrame.size.height = fitHeight
    headerView.frame = headerFrame
    tableView.tableHeaderView = headerView
}
// 关闭自动调整contentInset，防止headerView被导航栏遮挡或滚动偏移
tableView.contentInsetAdjustmentBehavior = .never

额外排查小技巧 #

• 如果你是把SearchBar放在自定义UIView里再作为headerView，要检查自定义view的约束是否正确，确保SearchBar不会被内部布局挤压或超出视图范围；
• 排查有没有其他代码（比如ScrollView的代理方法）无意中修改了navigationItem.hidesSearchBarWhenScrolling或SearchController的相关属性，动态覆盖了你的设置。

你可以根据自己的实现场景对应调整代码，一般来说设置好上面提到的核心属性，就能解决滚动隐藏的问题啦！

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