Xcode 26 中 SPM 无法导入 FirebaseAnalytics 怎么办？

2026-11-06数据小陈

结论

现有信息不足以确认问题由 Xcode 26 与 Firebase 12.7.0 不兼容引起，也无法确定唯一的修复方法。目前已知，项目链接了 FirebaseAnalytics，但 import FirebaseAnalytics 失败，而 FirebaseAnalyticsTarget 可以导入。删除 DerivedData、清理项目和重启 Xcode 都没有解决问题。接下来应确认 SPM 产品是否已加入报错文件所属的 target，并查看构建日志，确认编译器实际看到的模块和依赖。

FirebaseAnalyticsTarget 和 FirebaseAnalytics 是两个不同的导入名。原问题指出，导入前者无法提供所需用法，因此不能直接将它视为 FirebaseAnalytics 的替代品。

排查步骤

1. 核对 SPM 产品和应用 target

在 Xcode 的 Package Dependencies 中查看 Firebase 包提供的产品，并确认 FirebaseAnalytics 已加入包含报错代码的具体 target。项目中有这项依赖，或它出现在某处的 Frameworks、Libraries and Embedded Content 列表里，都不能单独证明报错文件所属的 target 已正确配置依赖。

先确认报错文件属于预期的 target，再检查该 target 的依赖配置。如果项目包含多个应用、扩展或测试 target，请逐一核对。

2. 让 Xcode 重新解析依赖

在 Xcode 中解析或更新包依赖，然后重新构建报错的 target。如果项目使用了 Package.resolved，请确认其中记录的 Firebase 版本是否符合预期。更新依赖前，也要确认项目是否需要固定版本，以免无意中更改其他依赖。

如果依赖配置看起来正确，可以先移除该产品，再将 FirebaseAnalytics 加回 target，观察 Xcode 是否重新生成对应的构建依赖。这一步用于排查项目配置，不能据此认定根因是缓存或解析状态。

3. 查看首次模块错误的构建日志

在 Report navigator 中打开失败的构建记录，找到最早出现的模块错误及对应的编译命令。确认错误来自哪个 target、哪个源文件，并检查构建过程中是否实际解析或构建了 FirebaseAnalytics。如果日志显示其他 target 或模块先失败，应先处理最早的错误，再判断导入问题是否仍然存在。

4. 保留预期的导入语句

如果代码需要使用 Firebase Analytics API，导入语句应与项目要使用的模块名一致：

import FirebaseAnalytics

FirebaseAnalyticsTarget 可以导入，并不意味着它提供相同的 API。现有信息没有提供具体 API 调用、完整错误日志或包解析结果，因此还无法判断问题出在产品解析、target 依赖还是模块构建阶段。

关于 Explicitly Build Modules

原问题提到，项目级别的 Explicitly Build Modules 已设为 No，但这没有解决当前报错。继续切换这项设置前，应先检查报错 target 的依赖配置和构建日志。现有信息不足以证明这项设置是根因或修复方法。

如果按上述步骤仍无法定位问题，请补充首次构建错误的完整内容、Xcode 26 的具体版本、Package.resolved 中 Firebase 的解析版本，以及报错 target 的类型，才能进一步判断。原始问题没有提供这些信息，也没有给出可验证的最终修复结果。