Swift本地包中ApiCalls结构体无法识别，报Cannot find in Scope错误

DevOps 小满

2026-8-8

Swift包中ApiCalls结构体无法被找到的排查与解决

核心排查点及解决步骤：

确保导入包模块：在调用ApiCalls的文件顶部，必须导入你的Swift包模块，比如：
```
import YourPackageName
```
替换YourPackageName为你实际的包名称，这是新手最容易遗漏的步骤。

同步关联类型的访问权限：你的ApiCalls结构体是public，但内部用到的ApiCallsRequestMethods、ApiCallErrors、ApiCallsRequestRequirements、Login_SignUp_Model这些类型也必须设置为public。如果这些类型是默认的internal权限，外部代码无法访问ApiCalls的方法，会间接导致"找不到ApiCalls"的错误。示例修正：

public enum ApiCallsRequestMethods {
    case GET, POST, PUT, DELETE
}

public enum ApiCallErrors: Error {
    case DomainMalformed, InvalidData, Unexpected, ErrorDecoding
}

public struct ApiCallsRequestRequirements {
    let subtitles: Bool?
    let token: [Bool: String]
    let body: [Bool: [String: Any]]

    public init(subtitles: Bool? = nil, token: [Bool: String], body: [Bool: [String: Any]]) {
        self.subtitles = subtitles
        self.token = token
        self.body = body
    }
}

public struct Login_SignUp_Model: Decodable {
    public let message: String
    // 补充其他必要属性
}

清理Xcode缓存并重建：Xcode的缓存可能导致编译异常，执行以下操作：
1. 按Cmd+Shift+K清理Build Folder
2. 重启Xcode
3. 重新构建项目和包
检查Package.swift配置：确认你的Package.swift文件中，目标(target)的sources包含了ApiCalls所在的.swift文件。比如：
```
targets: [
    .target(
        name: "YourPackageName",
        path: "Sources/YourPackageName"
    ),
]
```
确保ApiCalls.swift在指定的Sources目录下。