将Swift Framework导入Xcode应用项目时遇模块未找到及链接错误

针对你遇到的No such module 'ExpLib'及链接器错误ld: framework not found ExpLib，结合你的场景（示例项目正常、实际项目异常），可以从以下几个方向排查：

1. 校验编译配置一致性 #

确保ExpLib的Build Configuration（Debug/Release）与ExpApp完全匹配。比如App用Debug模式编译，但框架仅构建了Release版本，会导致链接时找不到对应产物。可通过Xcode → Product → Scheme → Edit Scheme查看两者的编译配置是否对应。

2. 检查框架的平台与架构设置 #

• 打开ExpLib项目，在Build Settings → Architectures中确认目标平台（iOS）与App一致，且Valid Architectures未遗漏当前设备/模拟器的架构；
• 检查App的Build Settings → Framework Search Paths，确保包含$(BUILT_PRODUCTS_DIR)（默认路径），若手动修改过路径可能导致框架找不到。

3. 确认依赖添加的完整性 #

• 除了在App的Frameworks, Libraries, and Embedded Content中添加ExpLib，还要在App的Build Phases → Target Dependencies里添加ExpLib目标，确保Xcode先编译框架再编译App；
• 根据框架类型设置Embed选项：动态框架选Embed & Sign，静态框架选Do Not Embed（静态框架无需嵌入，链接时直接合并到App二进制）。

4. 清理编译缓存 #

执行Xcode → Product → Clean Build Folder（快捷键Cmd+Shift+K），再删除Derived Data（路径：Xcode → Settings → Locations → Derived Data，点击箭头打开文件夹后删除对应项目的缓存），之后重新编译。缓存异常是这类问题的常见诱因。

5. 验证框架模块名正确性 #

打开ExpLib项目，查看Build Settings → Packaging → Product Module Name，确保该名称与你在App中import ExpLib的名称完全一致（区分大小写）。若模块名被修改过，会直接导致找不到模块。

6. 检查Workspace的项目引用 #

确认Workspace中的ExpLib项目引用路径正确：右键点击Workspace里的ExpLib项目，选择Show in Finder，查看文件路径是否有变动。若路径已修改，需重新将ExpLib项目添加到Workspace。

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