SwiftPM无法解析本地包提示Cannot find type in scope如何解决

问题场景 #

使用Xcode 13.2.1版本开发时，在根项目的AppCoordinator文件中引入本地包，编译器持续抛出错误：

Cannot find type 'DashboardFlow' in scope
其中DashboardFlow为待引入本地包的名称。已尝试清理DerivedData文件夹、逐个解析本地包、重启Xcode重解析依赖图三类操作后，错误依然存在。

可落地修复方案 #

按操作成本从低到高依次尝试即可：

• 检查代码访问权限：打开本地包中定义DashboardFlow的文件，确认该类型、对应公开初始化方法都添加了public修饰符。Swift中代码默认访问级别为internal，仅允许包内模块访问，跨模块引用必须显式标记为公开级别，这是最容易遗漏的基础问题。
• 校验包引用配置：打开主项目的Target设置页，进入「Frameworks, Libraries, and Embedded Content」板块，确认对应本地包的库产物已经被正确添加，没有出现红色缺失标记；同时打开本地包的Package.swift文件，确认DashboardFlow所在的库被正确列在products数组中，没有被误设为测试或者内部使用的target。
• 调整编译顺序：打开当前使用的Scheme编辑面板，进入Build标签页，取消勾选Parallelize Build并行编译选项，手动将引用的本地包拖拽到主项目Target的上方，保证Xcode优先编译本地包产物，再编译主项目代码，规避Xcode 13版本并行编译时的时序bug。
• 全量清理冗余缓存：除了清理DerivedData目录，还要关闭Xcode后删除项目根目录下的.swiftpm、xcuserdata、*.xcworkspace/xcuserdata三类缓存文件夹，避免旧的依赖解析缓存干扰；重新打开Xcode后，先选中本地包的Scheme单独执行一次编译，确认本地包本身无编译错误后，再切回主项目Scheme编译。
• 重新添加本地包引用：Xcode 13.2.1存在偶发的本地包路径识别失效bug，可在主项目的Package Dependencies列表中删除已添加的本地包，通过「Add Packages -> Add Local」入口重新选择本地包文件夹路径添加，避免相对路径解析错误导致的依赖失效。

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