求助：Xcode 14.3.1源码编辑器扩展自定义选项未在菜单显示

以下是针对你遇到问题的具体排查步骤，结合Xcode 14+版本的特性变化整理：

• 核对Info.plist核心配置
  检查扩展target的Info.plist中，NSExtension -> NSExtensionAttributes -> XCSourceEditorCommandDefinitions的配置是否符合要求：

  <key>NSExtensionAttributes</key>
  <dict>
    <key>XCSourceEditorCommandDefinitions</key>
    <array>
      <dict>
        <key>XCSourceEditorCommandClassName</key>
        <string>你的扩展模块名.命令类名</string>
        <key>XCSourceEditorCommandIdentifier</key>
        <string>唯一标识（如com.yourteam.yourextension.command1）</string>
        <key>XCSourceEditorCommandName</key>
        <string>菜单显示的自定义名称</string>
      </dict>
    </array>
  </dict>
  

  注意：Xcode 14对模块名校验更严格，XCSourceEditorCommandClassName必须包含扩展target的模块名（比如扩展target叫CodeEditExtension，类名是FormatCommand，这里要写CodeEditExtension.FormatCommand）。

• 检查扩展签名配置
  Xcode 14要求扩展必须使用开发者团队签名，不能选择“Sign to Run Locally”：

  • 进入扩展target的「Signing & Capabilities」面板，Team选择你的个人/团队开发者账号
  • 确保扩展的Bundle Identifier与主app关联（比如主app是com.yourteam.MyTool，扩展设为com.yourteam.MyTool.EditorExt）
  • 编译时确认控制台无签名相关警告或错误

• 确认扩展的运行方式
  运行扩展时，必须选择扩展target作为运行目标，在弹出的选择框中选中Xcode（或其他支持源码编辑器扩展的App）。不要直接运行主app，主app仅作为扩展的容器载体。

• 清理缓存并重置扩展服务
  缓存异常可能导致扩展无法加载，执行以下操作：

  1. 关闭所有Xcode实例
  2. 终端执行命令查看已加载的扩展：pluginkit -vvv -p com.apple.dt.Xcode.extension.source-editor，确认你的扩展是否在列表中
  3. 若未找到，执行命令卸载旧扩展：pluginkit -r 你的扩展路径（路径一般在~/Library/Developer/Xcode/DerivedData/.../Build/Products/Debug/下的.appex文件）
  4. 重置扩展服务：killall -9 pluginkit
  5. 重新运行扩展target，打开Xcode查看菜单

• 验证命令类代码逻辑
  确保你的XCSourceEditorCommand子类正确实现了perform(with:completionHandler:)方法，且方法内无初始化异常、未提前退出等问题。Xcode 14会隐藏执行逻辑有错误的扩展菜单。

• 对比同类项目配置
  将你的项目Info.plist、签名配置与XCFormat的扩展target配置逐项对比，重点排查NSExtension结构、Bundle ID规则、签名选项的差异，定位遗漏的配置项。

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