使用Xcode创建新项目后出现Missing required module '_SwiftUIKitOverlayShims'错误，该如何解决？

嘿，这个「Missing required module '_SwiftUIKitOverlayShims'」的错误我碰过好多次了，大多是缓存或者版本兼容的问题，试试下面这些方案，应该能解决：

1. 先清缓存，从头构建 #

缓存混乱是这类问题的头号元凶，先把Xcode的缓存清干净：

• 先关掉Xcode
• 打开Finder，按Shift + Command + G，输入~/Library/Developer/Xcode/DerivedData，把这个文件夹里的东西全删了（放心，这只是Xcode的临时缓存，不会动你的项目代码）
• 重新打开Xcode，按Shift + Command + K清理构建文件夹，然后点Product > Build重新编译

2. 检查Xcode版本和部署目标 #

这个_SwiftUIKitOverlayShims是SwiftUI的底层依赖，版本不匹配很容易出问题：

• 确保你用的是正式版最新Xcode，测试版Xcode经常会有这类底层模块的bug
• 看看项目的Deployment Target：如果设得太低（比如iOS 13及以下），而你用的是高版本Xcode，可能会出现依赖不兼容。试着把部署目标调到iOS 14或更高，再重新构建试试

3. 处理Swift Package Manager的依赖（如果用了SPM） #

如果项目里加了第三方Swift包，可能是包的缓存或者版本问题：

• 打开项目设置的Package Dependencies标签，给每个包点一下Update，更到最新版
• 要是更新没用，试试File > Packages > Reset Package Caches重置包缓存
• 极端情况可以先移除有问题的包，重新添加一次

4. 重置CocoaPods的Workspace（如果用了CocoaPods） #

用CocoaPods的话，有时候workspace文件会损坏：

• 关掉Xcode，打开终端进到项目根目录
• 执行pod deintegrate把Pods相关配置全清掉
• 再跑pod install重新生成xcworkspace
• 最后用新生成的xcworkspace打开项目，重新编译

5. 检查Build Settings的配置 #

个别Build Settings的错误也会导致模块找不到：

• 打开项目的Build Settings，搜索SWIFT_INCLUDE_PATHS，看看有没有错误的路径，有的话删掉
• 如果是测试目标出问题，搜索ENABLE_TESTABILITY，确保它设为YES

要是以上方法都不管用，重启一下Mac试试，有时候系统层面的缓存也会搞事情。

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