狀態欄文字有兩種顏色:黑(UIStatusBarStyleDefault)與白(UIStatusBarStyleLightContent)。導航欄是深色時該用白字,淺色時該用黑字,兩者需要搭配,否則文字會糊在背景裡看不見。
在視圖控制器中覆寫 preferredStatusBarStyle:
// 黑色文字,適合淺色背景
- (UIStatusBarStyle)preferredStatusBarStyle {
return UIStatusBarStyleDefault;
}
// 白色文字,適合深色背景
- (UIStatusBarStyle)preferredStatusBarStyle {
return UIStatusBarStyleLightContent;
}
若希望切換後立即生效,還要呼叫 setNeedsStatusBarAppearanceUpdate:
- (void)updateStatusBarStyle {
[self setNeedsStatusBarAppearanceUpdate];
}
最常見的原因是專案配置裡關閉了「基於視圖控制器控制狀態欄」。路徑:Target → Info → View controller-based status bar appearance。

最後一項就是狀態欄的相關設置,必須設為 YES,preferredStatusBarStyle 才會生效。設為 NO 時,系統改以 [[UIApplication sharedApplication] setStatusBarStyle:] 這套舊 API 為準。
preferredStatusBarStyle,此時要改 navigationBar.barStyle(UIBarStyleBlack 對應白字),或覆寫導航控制器的實現。UIModalPresentationOverFullScreen 呈現的控制器需要自行設定 modalPresentationCapturesStatusBarAppearance。prefersStatusBarHidden 控制顯示與否,同樣受上述開關影響。