Xcode 13中Swift项目添加本地Swift包提示无此模块如何解决

单纯将本地Swift包拖拽到项目文件夹内，不会自动完成Xcode的依赖关联配置，按以下步骤操作即可修复：

前置校验 #

• 先确认本地包本身结构合法：包根目录必须存在Package.swift配置文件，文件中通过name字段声明的包名、products下声明的库名，和你import语句写的模块名完全大小写一致（Swift模块名大小写敏感，比如声明为MyPackage时，写import myPackage必然报错）。可单独打开该本地包执行编译，确认包本身无语法错误、结构损坏问题。
• 清理之前错误拖拽产生的无效关联：如果之前直接把包文件拖进了Xcode左侧导航栏，选中对应包条目按Delete，选择Remove Reference即可，不要选Move to Trash避免误删本地文件。

正确添加本地包依赖的操作步骤 #

• 打开Xcode项目，点击左侧导航栏最顶部的蓝色项目图标，选中需要接入包的主Target，切换到General标签页
• 下拉找到Frameworks, Libraries, and Embedded Content区域，点击区域底部的+按钮
• 在弹出的选择窗口中，点击左下角Add Other...下拉选项，选择Add Package Dependency...
• 在弹出的依赖添加窗口中，直接通过文件导航定位到你项目下packages文件夹内的本地包根目录（选中包含Package.swift的层级即可），点击Add Package
• 等待Xcode完成包解析后，在弹出的目标关联窗口中，勾选所有需要使用该包的Target，点击确认完成添加

配置校验与缓存清理 #

• 回到项目设置页，切换到Package Dependencies标签页，确认刚添加的本地包条目存在，且路径显示为你本地packages目录下的相对路径，而非远程仓库地址
• 按Shift + Command + K快捷键执行项目Clean操作
• 完全退出Xcode，打开终端执行rm -rf ~/Library/Developer/Xcode/DerivedData/*清空Xcode全局派生缓存，避免旧的索引错误干扰
• 重新打开Xcode，等待索引加载完成后再编写import语句即可正常识别模块

常见踩坑 #

• 不要直接把本地包内的Swift源文件拖进项目的Compile Sources列表，会导致符号重复、模块冲突问题
• 多Target项目需要给每个使用该包的Target单独关联包产物，仅在项目级添加依赖不会自动同步到所有Target
• 如果本地包内声明了多个库产物，import时要写对应库的名称，不要直接用文件夹名或者根包名

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