Xcode Simulator仅显示空白白屏及应用标题,求排查方案
Xcode模拟器白屏问题排查建议
- 确认初始视图控制器设置:打开Storyboard,选中你要作为启动入口的控制器,在右侧Attributes Inspector面板中勾选「Is Initial View Controller」,确保界面左上角有指向该控制器的箭头标记——Xcode需要明确知道启动时加载哪个界面。
- 检查Storyboard与Target的关联:点击项目根目录进入设置界面,选择对应Target,切换到「General」标签,在「Deployment Info」区域确认「Main Interface」已选中你的Storyboard文件,而非空白选项。
- 排查启动逻辑代码:根据iOS版本查看
AppDelegate.swift或SceneDelegate.swift:- 若使用SceneDelegate,检查
scene(_:willConnectTo:options:)方法是否正确加载Storyboard并设置根控制器,示例正确代码:func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { guard let windowScene = (scene as? UIWindowScene) else { return } let window = UIWindow(windowScene: windowScene) let storyboard = UIStoryboard(name: "Main", bundle: nil) window.rootViewController = storyboard.instantiateInitialViewController() self.window = window window.makeKeyAndVisible() } - 若代码中存在自定义window逻辑但未正确关联Storyboard,会导致白屏。
- 若使用SceneDelegate,检查
- 验证控制器与Segue关联:选中Storyboard中的控制器,在右侧Identity Inspector确认「Class」已绑定对应的自定义控制器类(不要留空);检查模态Segue的连接是否正确(从按钮拖拽到目标控制器并选择正确的Segue类型)。
- 清理项目缓存:执行
Product > Clean Build Folder(快捷键Cmd+Shift+K),重启Xcode后重新编译运行。 - 重置模拟器状态:打开模拟器,执行
Simulator > Device > Erase All Content and Settings,清除模拟器缓存后重新运行项目。
内容的提问来源于stack exchange,提问作者Rebecca
相关产品推荐
相关产品推荐

