Xcode 26.0.1中SPM集成Alamofire编译失败：找不到指定框架

问题定性 #

这是Xcode 26.0.1（默认Swift 6.0）中Swift Package Manager（SPM）动态框架集成的已知兼容性Bug，仅在该版本出现，Xcode 15.x系列无此问题，已有大量开发者反馈引入Alamofire等动态库时触发类似文件路径缺失报错。

推荐解决方法 #

• 强制静态链接依赖库：
  1. 打开项目的「Package Dependencies」设置，选中目标第三方库（如Alamofire）；
  2. 在右侧面板的「Linking」选项中选择「Static」；
     或者直接在项目的Package.swift中为目标库添加staticLink: true配置，强制以静态方式编译链接。
• 调整框架Embed设置：
  进入主项目目标的「General」标签页，找到「Frameworks, Libraries, and Embedded Content」区域，将通过SPM引入的库的Embed选项改为「Do Not Embed」——SPM会自动处理框架的嵌入逻辑，手动设置Embed易引发路径冲突。
• 临时降级Xcode：
  若上述方法无效，可暂时降级至Xcode 15.4（兼容macOS Sequoia 15.6），等待Apple推送Xcode 26系列的Bug修复更新后再升级。
• 额外排查动作：
  检查项目Build Settings中的FRAMEWORK_SEARCH_PATHS是否包含$(inherited)，确保SPM生成的框架路径能被编译器正确识别；尝试创建全新的Xcode 26测试项目重新集成SPM库，排除旧项目配置残留的干扰。

内容的提问来源于stack exchange，提问作者Ruveyda Bingöl