Xcode依赖包已安装却报错‘No such module‘？深入解析框架路径配置陷阱

1. 为什么会出现"No such module"错误？

当你看到Xcode报错"No such module 'Alamofire'"时，内心一定是崩溃的。明明左侧导航栏的Package Dependencies里已经显示安装成功了，为什么还是找不到模块？这个问题困扰过无数开发者，包括我自己。

首先需要理解的是，Xcode的包管理机制其实分为两个独立的部分：安装和链接。安装成功只意味着包已经下载到本地，但要让编译器找到它，还需要正确的链接配置。这就好比你在网上买了本书（安装），但如果不把它放到书架上（链接），你还是找不到它。

常见的触发场景包括：

• 使用Swift Package Manager添加依赖后直接编译
• 从CocoaPods迁移到SPM时
• 项目中有多个target但只给部分target添加了依赖
• Xcode版本升级后配置被重置

2. 基础解决方案：手动添加框架

2.1 检查Frameworks列表

最直接的解决方法就是手动将包添加到项目的Frameworks列表中：

1. 在项目导航器中选择你的项目文件
2. 切换到General标签页
3. 找到"Frameworks, Libraries, and Embedded Content"部分
4. 点击+按钮添加缺失的框架

# 检查是否已正确添加
$ ls -l ~/Library/Developer/Xcode/DerivedData/YourProject-*/Build/Products/Debug/

2.2 验证框架搜索路径

有时候框架已经添加但仍然找不到，可能是因为搜索路径有问题：

1. 选择项目文件 → Build Settings
2. 搜索"Framework Search Paths"
3. 确保包含$(inheri