升级Xcode 13后Swift编译报Cannot find 'ClassName.h' in scope错误求助

该问题属于Xcode 13的已知兼容性Bug，大量Objective-C与Swift混编的项目升级Xcode版本后都会遇到同类异常，表现为项目可正常构建运行、功能无异常，但编译器持续抛出错误提示，属于Xcode索引逻辑缺陷导致的误报。

排查解决步骤 #

• 首先排查Swift代码中的错误导入语句：桥接头文件中已经导入的Objective-C类，不需要在Swift代码中额外添加import ClassName.h语句，直接使用类名即可调用，该错误导入语句是触发Swift 编译器错误：在作用域中无法找到“ClassName.h”的最常见原因。
• 调整桥接头预编译配置：进入对应Target的Build Settings页面，将Precompile Bridging Header设置为No，Xcode 13对预编译桥接头的索引解析存在逻辑缺陷，关闭该配置即可解决大多数误报问题。
• 补全头文件搜索路径：在Build Settings的User Header Search Paths配置项中添加项目根目录，检索权限设置为recursive，确保编译器索引过程中可以定位到所有引用的Objective-C头文件。
• 重置Xcode全局索引缓存：除删除Derived Data、清理项目外，可执行终端命令defaults delete com.apple.dt.Xcode IDEIndexDisable，重启Xcode后等待索引重建完成即可清除历史异常缓存导致的误报。

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