Swift导航栏动画异常求助：Push与返回时的显示故障

这类导航栏和搜索栏的动画冲突问题我之前踩过不少坑，大概率是导航栏外观设置时机不对，或者和UISearchBar的层级、状态管理冲突导致的，咱们一步步来排查解决：

一、解决Push新VC时的黑色背景与取消按钮动画故障 #

1. 黑色背景问题排查

黑色背景这个坑我之前也栽过，多半是导航栏半透明属性没设置对，或者背景色更新时机没跟上过渡动画的节奏：

• 先统一设置导航栏的半透明状态，避免过渡时出现系统默认的黑色底色：

  // 在基础ViewController的viewDidLoad里全局配置
  navigationController?.navigationBar.isTranslucent = false
  navigationController?.navigationBar.barTintColor = .red // 你的目标红色
  

• 别在viewWillAppear/viewDidAppear里直接硬改背景色，如果必须在生命周期里调整，一定要用动画包裹，跟系统过渡动画同步：

  override func viewWillAppear(_ animated: Bool) {
      super.viewWillAppear(animated)
      UIView.animate(withDuration: animated ? 0.3 : 0) {
          self.navigationController?.navigationBar.barTintColor = .red
      }
  }
  

2. 取消按钮未消失的动画问题

如果你是直接把UISearchBar塞到导航栏的子视图里，很容易出现动画不同步的问题，建议改用UISearchController嵌入到navigationItem中——系统会自动帮你处理过渡动画：

// 替换手动添加UISearchBar的写法
let searchController = UISearchController(searchResultsController: nil)
searchController.searchBar.delegate = self
// 确保Push时搜索栏状态能正常重置
searchController.hidesNavigationBarDuringPresentation = false
navigationItem.searchController = searchController

// 自定义取消按钮的显示/隐藏逻辑
func searchBarTextDidBeginEditing(_ searchBar: UISearchBar) {
    searchBar.showsCancelButton = true
}

func searchBarTextDidEndEditing(_ searchBar: UISearchBar) {
    searchBar.showsCancelButton = false
}

另外，在触发Push的代码里，一定要先重置搜索栏状态再跳转，不然取消按钮会卡在界面上：

// 比如点击某个按钮Push新VC时
@IBAction func pushNewVC(_ sender: UIButton) {
    searchController.searchBar.resignFirstResponder()
    searchController.searchBar.showsCancelButton = false
    let newVC = NewViewController()
    navigationController?.pushViewController(newVC, animated: true)
}

二、解决返回时搜索栏先白再红的显示异常 #

这个问题本质是导航栏背景色的过渡动画没和返回动画同步，你可以通过导航栏代理来统一管控颜色变化：

// 让基础ViewController遵守UINavigationControllerDelegate
class BaseViewController: UIViewController, UINavigationControllerDelegate {
    override func viewDidLoad() {
        super.viewDidLoad()
        navigationController?.delegate = self
    }

    func navigationController(_ navigationController: UINavigationController, willShow viewController: UIViewController, animated: Bool) {
        // 判断是否是回到当前页面
        if viewController == self {
            // 用动画同步返回节奏
            UIView.animate(withDuration: animated ? 0.3 : 0) {
                navigationController.navigationBar.barTintColor = .red
            }
        } else {
            // Push到新页面时，同步设置新页面的导航栏颜色（如果需要的话）
            UIView.animate(withDuration: animated ? 0.3 : 0) {
                navigationController.navigationBar.barTintColor = .white // 新页面的导航栏颜色
            }
        }
    }
}

另外检查下新ViewController的viewWillAppear里是不是硬设了导航栏为白色，如果是，也要用动画包裹，不然返回时系统会先显示新页面的白色，再切回红色，就会出现闪白的情况。

额外避坑提示 #

• 别手动修改导航栏的子视图层级（比如直接加UISearchBar到navigationBar.subviews），这种操作很容易破坏系统的动画逻辑，优先用navigationItem.searchController或者navigationItem.titleView。
• 如果开了大标题模式（prefersLargeTitles），动画逻辑和普通模式不一样，需要单独适配。
• 可以打开Debug模式的“Color Blended Layers”，确认黑色背景不是视图透明度混合导致的。

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