嘿，我刚好做过类似的需求，日历和健身App的这种导航栏布局确实有点 tricky，默认的UINavigationBar行为不太好直接适配，我来分享下我踩坑后总结的解决方案：

首先先明确你的核心需求：

• 透明背景的导航栏，保留顶部滚动边缘效果（topEdgeEffect）
• 大标题不随滚动收缩，始终保持展开状态
• 大标题下方的自定义视图始终显示，不被裁剪或超出边缘

第一步：配置导航栏的透明外观 #

先把导航栏设置为透明风格，去掉默认阴影，对齐目标App的视觉效果：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 启用大标题模式
    navigationController?.navigationBar.prefersLargeTitles = true
    navigationItem.largeTitleDisplayMode = .always
    
    // 配置透明导航栏外观
    let navAppearance = UINavigationBarAppearance()
    navAppearance.configureWithTransparentBackground()
    navAppearance.shadowColor = .clear // 移除导航栏底部的默认阴影线
    navAppearance.largeTitleTextAttributes = [.foregroundColor: UIColor.label] // 可自定义大标题的字体/颜色
    
    // 给所有状态的导航栏应用该外观
    navigationController?.navigationBar.standardAppearance = navAppearance
    navigationController?.navigationBar.scrollEdgeAppearance = navAppearance
    navigationController?.navigationBar.compactAppearance = navAppearance
    navigationController?.navigationBar.isTranslucent = true
}

第二步：添加自定义视图并解决布局约束问题 #

直接用titleView或自定义subtitle的方式会受系统布局限制，容易出现裁剪或超出边缘的问题，正确的做法是把自定义视图直接添加到UINavigationBar的子视图中，手动控制布局：

// 在viewDidLoad中继续添加以下代码
guard let navBar = navigationController?.navigationBar else { return }

// 创建你的自定义视图（这里以高度60的示例视图为例，可替换为你需要的视图）
let customUnderTitleView = UIView()
customUnderTitleView.backgroundColor = .systemGray5.withAlphaComponent(0.5)
customUnderTitleView.translatesAutoresizingMaskIntoConstraints = false
navBar.addSubview(customUnderTitleView)

// 设置约束：对齐导航栏左右内边距，顶部接大标题底部
NSLayoutConstraint.activate([
    customUnderTitleView.leadingAnchor.constraint(equalTo: navBar.layoutMarginsGuide.leadingAnchor),
    customUnderTitleView.trailingAnchor.constraint(equalTo: navBar.layoutMarginsGuide.trailingAnchor),
    customUnderTitleView.topAnchor.constraint(equalTo: navBar.layoutMarginsGuide.topAnchor, constant: 44), // 44是iOS16+大标题的默认高度
    customUnderTitleView.heightAnchor.constraint(equalToConstant: 60) // 自定义视图的高度，按需调整
])

// 关键：让自定义视图层级低于边缘效果，避免遮挡topEdgeEffect
customUnderTitleView.layer.zPosition = -1

第三步：禁用大标题的自动收缩行为 #

默认大标题会随滚动收缩，我们需要让导航栏始终保持展开的大标题高度，这里提供两种可选方案：

方案1：自定义UINavigationBar子类（推荐）

重写sizeThatFits方法，固定导航栏的总高度（大标题高度+自定义视图高度）：

class FixedHeightNavigationBar: UINavigationBar {
    override func sizeThatFits(_ size: CGSize) -> CGSize {
        let defaultSize = super.sizeThatFits(size)
        // 60为自定义视图的高度，根据实际值调整
        return CGSize(width: defaultSize.width, height: defaultSize.height + 60)
    }
}

初始化导航控制器时使用这个子类：

let navController = UINavigationController(navigationBarClass: FixedHeightNavigationBar.self, toolbarClass: nil)
navController.viewControllers = [YourTargetViewController()]

方案2：调整滚动视图的内容内边距

如果不想自定义导航栏子类，可以通过调整滚动视图的内边距，让内容从自定义视图下方开始，间接让导航栏保持展开状态：

// 在你的ViewController中添加
if let scrollView = view as? UIScrollView {
    scrollView.contentInsetAdjustmentBehavior = .never
    // 导航栏高度 + 自定义视图高度，作为内容的顶部内边距
    let topInset = (navigationController?.navigationBar.frame.height ?? 0) + 60
    scrollView.contentInset = UIEdgeInsets(top: topInset, left: 0, bottom: 0, right: 0)
    scrollView.scrollIndicatorInsets = scrollView.contentInset
}

常见问题排查 #

• 自定义视图仍被裁剪：检查导航栏的clipsToBounds是否被设为true，确保设置为false
• 大标题还是会收缩：确认navigationItem.largeTitleDisplayMode设为.always，且navigationBar.prefersLargeTitles为true
• 透明背景不生效：确保navigationBar.isTranslucent设为true，只有半透明导航栏才能应用透明外观配置

内容来源于stack exchange