SwiftUI macOS开发：如何为菜单栏帮助菜单添加应用帮助支持

1. 制作符合macOS规范的Help Book资源 #

• 准备纯HTML格式的帮助页面，主入口文件命名为index.html，页面内所有跳转链接、资源引用（图片、样式表）都使用相对路径。
• 将所有帮助相关文件归到同一目录，给目录添加.helpbundle后缀，例如应用名为DemoApp时，目录命名为DemoApp.helpbundle。
• 如需支持多语言帮助，可在.helpbundle目录下添加对应语言的.lproj子目录，将对应语言的帮助资源放入即可，系统会自动根据用户系统语言加载匹配的帮助内容。
• 给该.helpbundle目录创建配套的Info.plist文件，添加两个必填配置：
  • CFBundleIdentifier：填写全局唯一的标识，例如com.yourcompany.demoapp.help
  • CFBundleName：填写帮助文档的显示名称，例如DemoApp Help

2. 将帮助资源集成到Xcode项目 #

• 把制作完成的.helpbundle直接拖拽到Xcode项目导航栏，弹窗中勾选当前应用的目标，确认「Copy items if needed」处于选中状态。
• 打开应用目标的「Build Phases」面板，展开「Copy Bundle Resources」列表，确认.helpbundle已包含在列表中，缺失则手动添加。

3. 在应用主Info.plist中声明帮助配置 #

• 打开应用项目的Info.plist文件，添加两个必填键值对：
  • CFBundleHelpBookFolder：值填写.helpbundle的完整文件名，例如DemoApp.helpbundle
  • CFBundleHelpBookName：值填写和.helpbundle内部Info.plist中CFBundleName完全一致的字符串，例如DemoApp Help；为了减少后续改名的维护成本，两处都可以统一填写$(PRODUCT_NAME) Help，应用名称变更时系统会自动同步值。

4. 配置验证与排查 #

• 重新编译运行应用，点击顶部菜单栏「帮助」→「（应用名称）帮助」，系统会自动调用Help Viewer加载你制作的帮助内容，不再弹出“暂无可用帮助内容”的提示。
• 若配置后仍不生效，按以下顺序排查：
  • 检查.helpbundle后缀拼写是否正确，不能误写为.help或其他格式
  • 检查两处CFBundleHelpBookName值完全匹配，无拼写、大小写错误
  • 右键点击编译产物的.app文件，选择「显示包内容」，进入Contents/Resources目录，确认.helpbundle已被正确打包

内容的提问来源于stack exchange，提问作者Denny L.