Xcode 14 + iOS 16环境下SwiftUI项目归档构建失败原因排查

以下是针对Xcode 14.2归档时出现Cannot Find '[insert file name].swift' in scope错误的排查方案：

• 检查编译条件与归档配置差异
  真机运行和归档的编译配置可能存在区别，重点排查自定义编译宏或#if条件编译语句。确认报错文件的引用处是否存在仅在Debug模式下生效的条件，导致Release/归档模式下该文件被排除在编译范围外。

• 验证模块导入与命名空间
  若报错文件属于自定义模块，确认引用它的文件是否正确导入了该模块。SwiftUI中Debug模式可能依赖Xcode缓存机制正常工作，但归档时的严格编译检查会暴露模块未正确导入的问题。

• 调整文件编译顺序
  进入Xcode的Build Phases > Compile Sources，检查报错文件是否在引用它的文件之后编译。如果引用文件先被处理，此时报错文件还未被编译，就会触发不在作用域的错误。尝试将被引用的文件移到引用文件上方。

• 排查重复文件或命名冲突
  检查项目中是否存在同名文件（即使在不同目录），归档时的编译逻辑对命名冲突更敏感，可能导致Xcode无法正确解析目标文件。可以给冲突文件重命名，或确认文件的Target Membership未被意外添加到无关目标。

• 临时修改归档优化级别
  Xcode 14.2的Release模式优化可能引发SwiftUI代码解析异常。在Build Settings > Optimization Level中，将归档对应的配置（通常是Release）从Fast, Whole Module Optimization改为None，完成归档后再改回原配置。

• 排查SwiftUI预览代码影响
  如果报错文件包含#Preview代码块，尝试暂时注释掉预览代码后再归档。部分Xcode版本在处理预览代码时，归档阶段可能出现编译逻辑冲突，导致主代码的引用解析失败。

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