MacOS下Swift开发：Help菜单触发PDF无法显示问题排查

安全阿岳

2026-7-10

问题分析与解决方案

核心问题

未加载关联界面文件：直接调用ViewController()初始化时，系统不会自动加载对应的xib/storyboard文件，导致@IBOutlet var pdfView始终为nil，且viewDidLoad方法不会被触发——该方法只有在控制器的view被首次访问时才会执行。
未展示控制器视图：即使正确初始化控制器，也没有将其视图添加到应用的窗口层级中，所以用户看不到任何内容。

具体修复步骤

1. 确认界面关联正确

确保ViewController.swift已关联对应的ViewController.xib文件：在Xcode中选中ViewController.swift，查看右侧Identity Inspector，确认"Class"为ViewController，且xib关联正确。
检查xib中的PDFView控件已通过拖拽绑定到ViewController的pdfViewIBOutlet：选中xib中的PDFView，查看Connections Inspector，确认已连接到pdfView属性。

2. 修改菜单触发代码

替换原usage函数，改为正确加载控制器并通过新窗口展示PDF：

func usage() {
    // 加载关联xib的ViewController
    guard let vc = ViewController(nibName: "ViewController", bundle: nil) else {
        print("无法加载ViewController")
        return
    }
    
    // 创建用于展示PDF的窗口
    let window = NSWindow(
        contentRect: NSRect(x: 200, y: 200, width: 800, height: 600),
        styleMask: [.titled, .closable, .resizable, .miniaturizable],
        backing: .buffered, defer: false)
    window.contentViewController = vc
    window.title = "Usage"
    window.makeKeyAndOrderFront(nil)
}

3. 验证PDF文件存在于Bundle中

确认sample.pdf已添加到Xcode项目，且在Target的Build Phases > Copy Bundle Resources列表中包含该文件——否则Bundle.main.path(forResource: "sample", ofType: "pdf")会返回nil。