iOS 17问题：在Xcode 15中添加Navigation Controller后导航栏未即时显示

• 确认导航控制器是初始视图控制器
  嵌入导航控制器后，必须确保Storyboard里的Navigation Controller被设为入口。操作：选中导航控制器，打开右侧「Attributes Inspector」（快捷键Cmd+Option+4），勾选「Is Initial View Controller」。如果仍以原ViewController作为初始入口，预览时不会加载导航控制器，自然看不到导航栏。

• 检查ViewController的导航栏隐藏设置

  1. 打开对应的ViewController代码，排查是否存在以下代码：

     navigationController?.isNavigationBarHidden = true
     // 或者
     override var prefersNavigationBarHidden: Bool { return true }
     

     若有，删除或改为false。
  2. 回到Storyboard，选中该ViewController，在右侧「Attributes Inspector」的「Navigation Bar」区域，确认「Hidden」选项未被勾选。

• 清理Xcode缓存并重启
  Xcode15的Storyboard预览偶尔会出现缓存异常。执行以下步骤：

  1. 菜单栏选择「Product」->「Clean Build Folder」（快捷键Cmd+Shift+K）
  2. 关闭Xcode，重新打开项目后再查看预览。

• 检查导航栏的显示属性
  选中Navigation Controller内的Navigation Bar，打开右侧「Attributes Inspector」：

  • 确认「Hidden」未被勾选
  • 查看「Bar Tint」颜色，若设置为透明或与ViewController背景色一致，会看起来像未显示，可临时改为其他颜色测试
  • 将「Style」切换为「Default」，避免因半透明样式与背景重叠导致视觉上不可见

• 验证实际运行效果
  有时候Storyboard预览和实际运行存在差异，直接点击运行按钮在iPhone15模拟器中启动应用，查看导航栏是否正常显示。如果运行后显示正常，大概率是Xcode预览的bug，无需额外操作，后续预览可能自行恢复。

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