Apple Swift macOS：如何打开应用的帮助手册？

我来帮你搞定这个问题！你遇到的情况很常见，咱们一步步拆解：

为什么showHelp()不在作用域？ #

showHelp()是NSApplication的实例方法，不是全局函数也不是当前类的方法，所以直接写showHelp()肯定找不到。你需要通过NSApplication的共享实例来调用它：

// Swift 示例
NSApplication.shared.showHelp()

// Objective-C 示例
[[NSApplication sharedApplication] showHelp];

为什么showContextHelp()没用？ #

showContextHelp()的作用是显示上下文相关帮助（比如某个按钮、控件的具体帮助说明），而不是打开整个应用的帮助手册。它需要你提前给控件绑定帮助标记，并且配置好帮助书中对应的条目，所以用它来打开全局帮助本来就不对路子。

确保你的帮助手册配置正确 #

就算调用对了方法，如果帮助书本身没配置好，也打不开。检查这几个关键步骤：

• 确认项目包含帮助书（.help文件）：你的应用bundle里必须包含一个合法的.help包，通常放在Contents/Resources目录下。
• 配置Info.plist的关键键值：在应用的Info.plist中添加以下两个键（如果没有的话）：
  • CFBundleHelpBookName：值为你的帮助书的Bundle Identifier（比如com.yourcompany.YourApp.help）
  • CFBundleHelpBookFolderPath：值为帮助书在应用bundle中的相对路径，比如Contents/Resources/YourApp.help
• 测试帮助书本身是否有效：找到应用包内的.help文件，双击它，如果能正常打开，说明帮助书本身没问题；如果打不开，你需要先修复帮助书的制作问题（可以用Apple的Help Authoring Kit或者第三方工具来生成正确的帮助书）。

沙箱应用的额外注意事项 #

如果你的应用开启了App Sandbox，确保帮助书的路径配置正确，沙箱会限制应用访问bundle外的资源，所以帮助书必须打包在应用bundle内，路径不能写错。

SwiftUI应用的特殊处理 #

如果是SwiftUI的@main App结构，直接调用NSApplication.shared.showHelp()就可以，比如在菜单命令里：

Menu("Help") {
    Button("Your App Help") {
        NSApplication.shared.showHelp()
    }
}

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