You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Xcode 14无法在多设备预览UI,快捷键及预览按钮失效求助

Xcode 14 多设备UI预览失效问题解决办法

针对Xcode 14中UI预览快捷键失效、预览按钮消失的问题,可按以下步骤排查解决:

1. 显式添加Preview Provider代码

Xcode 14对UI预览的触发要求更严格,必须显式编写Preview Provider代码才能唤起预览。在你的ViewController.swift文件末尾添加以下代码:

import SwiftUI

struct ViewControllerPreview: PreviewProvider {
    static var previews: some View {
        // 加载指定Storyboard中的ViewController
        UIViewControllerPreviewWrapper(UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "ViewController"))
            .previewDevice(PreviewDevice(rawValue: "iPhone 14"))
            .previewDisplayName("iPhone 14")
        
        // 追加多设备预览,按需添加更多设备
        UIViewControllerPreviewWrapper(UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "ViewController"))
            .previewDevice(PreviewDevice(rawValue: "iPad Pro (12.9-inch) (6th generation)"))
            .previewDisplayName("iPad Pro 12.9")
    }
}

// 用于包装UIViewController的SwiftUI适配视图
struct UIViewControllerPreviewWrapper: UIViewControllerRepresentable {
    let viewController: UIViewController
    
    func makeUIViewController(context: Context) -> UIViewController {
        viewController
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {}
}

注意:

  • 替换"Main"为你的实际Storyboard文件名
  • 替换"ViewController"为该视图控制器在Storyboard中设置的Storyboard ID(可在Identity Inspector面板中查看/设置)

2. 检查预览面板的显示状态

  • 使用快捷键 Cmd + Shift + L 打开Library面板,切换到「Preview」标签页,尝试唤起预览
  • 若面板未显示,点击Xcode顶部菜单栏 View > Inspectors > Show Preview Inspector,确保预览检查器已启用

3. 重置Xcode界面状态

Xcode的窗口布局或面板状态异常可能导致预览功能失效:

  1. 完全关闭Xcode
  2. 前往路径 ~/Library/Developer/Xcode/,删除UserInterfaceState.xcuserstate文件
  3. 重新启动Xcode,界面会恢复默认状态

4. 验证快捷键设置

  • 打开系统设置 Keyboard > Shortcuts > App Shortcuts,检查是否有自定义快捷键与Xcode的预览快捷键冲突
  • 或在Xcode偏好设置中(Preferences > Key Bindings)搜索「Preview」,确认Show Preview的快捷键是否为Cmd + Option + Return,若被修改可手动恢复默认设置

内容的提问来源于stack exchange,提问作者anas alassi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.13 14:01:40