自定义Navigation Controller下搜索栏未与返回按钮对齐的问题求助

这种情况大概率是导航栏的标题占位区域在偷偷占用空间——哪怕你没设置标题，系统也会默认保留这个区域的布局优先级，把搜索栏挤到右边。下面是几个亲测有效的解决办法，按推荐程度排序：

方法1：清空标题并消除占位布局 #

在你添加搜索控制器的ViewController的viewDidLoad里，直接把导航项的标题设为空，同时用一个空视图占据标题位置，彻底消除系统默认的占位：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 1. 清空标题+设置空titleView，让系统不再保留标题区域的布局空间
    navigationItem.title = ""
    navigationItem.titleView = UIView(frame: .zero)
    
    // 2. 初始化并绑定搜索控制器
    let searchController = UISearchController(searchResultsController: nil)
    searchController.searchBar.placeholder = "输入关键词搜索..."
    // 若不需要滚动时隐藏搜索栏，设为false
    navigationItem.hidesSearchBarWhenScrolling = false
    navigationItem.searchController = searchController
}

这个方法直接从布局根源消除了标题占位，搜索栏会自动左移紧贴返回按钮。

方法2：调整导航栏全局布局参数 #

如果方法1没生效，可能是你的自定义Navigation Controller里有全局布局设置影响了效果。可以在当前ViewController里针对性调整：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    
    // 缩小导航栏的布局边距，消除额外留白
    navigationController?.navigationBar.layoutMargins = UIEdgeInsets(top: 0, left: 0, bottom: 0, right: 0)
    // 确保大标题模式关闭（大标题会强制占据标题区域）
    navigationController?.navigationBar.prefersLargeTitles = false
    
    // 额外检查：如果自定义NC里设置过返回按钮标题，记得清空避免占位
    navigationItem.backButtonTitle = ""
}

方法3：手动构建导航栏左侧布局 #

如果上面两种方法都不行，你可以完全自定义导航栏左侧的item组合，精确控制返回按钮和搜索栏的间距：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 1. 创建自定义返回按钮
    let backButton = UIBarButtonItem(image: UIImage(systemName: "chevron.left"), 
                                     style: .plain, 
                                     target: self, 
                                     action: #selector(backButtonTapped))
    
    // 2. 创建搜索栏并设置约束
    let searchBar = UISearchBar()
    searchBar.placeholder = "搜索..."
    searchBar.sizeToFit()
    // 给搜索栏设置宽度，避免显示异常
    searchBar.widthAnchor.constraint(equalToConstant: UIScreen.main.bounds.width - 80).isActive = true
    let searchBarItem = UIBarButtonItem(customView: searchBar)
    
    // 3. 将两个item绑定到导航栏左侧
    navigationItem.leftBarButtonItems = [backButton, searchBarItem]
}

@objc func backButtonTapped() {
    navigationController?.popViewController(animated: true)
}

这个方法完全绕开了系统默认的标题布局逻辑，精准控制导航栏左侧的元素排列。

关键注意点： #

• 检查自定义Navigation Controller的全局设置，是否开启了prefersLargeTitles——大标题模式会强制占用标题区域，必须在当前VC关闭才会生效。
• 确认没有给titleView设置过任何非空的自定义视图，哪怕是隐藏的，也可能会占据布局空间。

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