iOS导入UIKit仍报错找不到作用域内UIDevice如何解决

常见触发原因 #

• 代码运行/编译目标非iOS/iPadOS平台：UIDevice是UIKit框架中专供iOS、iPadOS使用的类，即使导入了UIKit，如果当前编译目标是macOS、watchOS、tvOS或者跨平台框架的非iOS端，Xcode会判定该类型不存在。
• 多Target项目配置错误：存放UIDevice相关代码的文件被误勾选到了非iOS平台的编译目标中，编译非iOS端代码时会尝试解析该段iOS专用逻辑，抛出找不到类型的错误。
• Xcode索引或缓存损坏：DerivedData缓存、项目编译缓存异常时，即使是正常iOS target，也可能出现类型识别错误的误报。

对应修复方案 #

1. 添加平台兼容判定
   如果项目需要支持多端运行，通过编译宏隔离iOS专用代码，仅在iOS环境下调用UIDevice相关能力，示例代码：

   #if os(iOS)
   // 获取设备ID的逻辑仅在iOS端编译执行
   let deviceId = UIDevice.current.identifierForVendor?.uuidString
   #endif
   

   也可以通过可用性标注限定方法的适用平台：

   @available(iOS, *)
   func getDeviceIdentifier() -> String? {
       return UIDevice.current.identifierForVendor?.uuidString
   }
   

2. 修正Target Membership配置
   在Xcode左侧文件导航栏选中写有UIDevice逻辑的代码文件，打开右侧的File Inspector面板，找到Target Membership板块，仅保留iOS/iPadOS对应target的勾选，取消watchOS、macOS等其他非iOS平台target的勾选。
3. 清理Xcode缓存修复索引异常
   确认编译目标为iOS仍报错时，按以下步骤清理缓存即可：
   • 按下Command + Shift + K快捷键，清理项目现有编译产物
   • 关闭Xcode，打开访达前往~/Library/Developer/Xcode/DerivedData目录，删除对应项目的缓存文件夹
   • 重启Xcode后重新编译项目

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