使用SPM在Xcode中添加OpenAPIGenerator插件至构建工具插件遇阻

• 检查Package.swift的插件配置是否完整
  确认插件已在目标的plugins数组中关联，而不只是在package的plugins列表里声明。正确的配置示例：

  plugins: [
      .package(url: "https://github.com/apple/swift-openapi-generator.git", from: "1.0.0")
  ],
  targets: [
      .target(
          name: "MyTarget",
          dependencies: [
              .product(name: "OpenAPIRuntime", package: "swift-openapi-generator"),
              .product(name: "OpenAPIURLSession", package: "swift-openapi-generator"),
          ],
          plugins: [
              .plugin(name: "OpenAPIGenerator", package: "swift-openapi-generator")
          ]
      )
  ]
  

• 刷新SPM依赖并重启Xcode
  执行File → Packages → Reset Package Caches等待依赖重新加载，之后完全退出Xcode（包括后台进程）再重新打开项目。

• 验证Xcode版本兼容性
  确保使用Xcode 15.0及以上版本，构建插件是Xcode 15才引入的特性，旧版本不支持。

• 确认目标类型支持构建插件
  构建插件仅适配SPM管理的目标，如果MyTarget是Xcode传统项目目标（非SPM包目标），需要将目标迁移为SPM管理，或者把插件配置在SPM子包中，让Xcode目标依赖该子包。

• 手动验证插件有效性
  打开Xcode的Package Dependencies面板，查看swift-openapi-generator包下是否包含OpenAPIGenerator插件；也可以在终端项目根目录执行swift package generate-openapi --input openapi.yaml --target MyTarget，如果能正常生成代码，说明插件配置本身没问题，只是Xcode界面未同步。

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