Swift Package Manager公开类提示‘not found in scope’的解决方法

以下是几个可行的排查和修复步骤：

• 核对模块目录结构
  Swift包的默认模块规则是：源文件需放在Sources/[模块名]/目录下（比如Sources/NevaehSPM/）。如果你的GateKeeper类直接放在Sources根目录，Xcode可能无法正确将其归属到NevaehSPM模块中，导致导入后无法识别。调整目录结构，把类文件移到对应模块名的子目录下。

• 检查package.swift的目标配置
  确保package.swift中的目标路径和模块名匹配，示例配置如下：

  let package = Package(
      name: "NevaehSPM",
      products: [
          .library(name: "NevaehSPM", targets: ["NevaehSPM"]),
      ],
      targets: [
          .target(
              name: "NevaehSPM",
              path: "Sources/NevaehSPM" // 对应类所在的模块子目录
          ),
      ]
  )
  

  若坚持把文件放在Sources根目录，需确保path设置为"Sources"，且目标名称与导入的模块名完全一致。

• 清理Xcode缓存并重启
  Xcode的索引缓存容易引发这类识别异常，执行以下操作：

  • 关闭Xcode
  • 删除~/Library/Developer/Xcode/DerivedData下的全部内容
  • 重新打开项目，等待索引构建完成

• 验证类的访问控制完整性
  确认GateKeeper类的所有必要部分都正确设置了public访问级别：

  • 类声明：public class GateKeeper: NSObject, UIApplicationDelegate（作为AppDelegate适配需遵守UIApplicationDelegate协议）
  • 初始化方法：public override init()（需明确标记为public，避免默认的internal级别）

• 确认项目与包的关联状态
  检查项目的Package Dependencies是否已正确添加本地Swift包，同时在目标的Frameworks, Libraries, and Embedded Content列表中，确认NevaehSPM模块已被添加。

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