SwiftUI使用NSViewRepresentable创建模糊视图报错找不到类型，新建项目无异常

前提说明：NSViewRepresentable、NSVisualEffectView为macOS平台独有的类型，iOS环境无对应实现

• 补充导入AppKit框架
  • 仅导入SwiftUI在部分旧项目配置下不会自动导出全部AppKit类型，在文件顶部添加import AppKit，即可解决NSVisualEffectView无法识别的问题
• 校验文件Target归属与平台匹配性
  • 若当前为跨平台项目，或该Swift文件被关联到iOS Target：
    • 打开右侧File Inspector（快捷键⌥⌘1）
    • 在Target Membership区块取消iOS Target的勾选，仅保留macOS对应Target
    • 编译iOS Target时，macOS独有的AppKit、SwiftUI AppKit集成类型不存在，因此会触发NSViewRepresentable、Context找不到的报错
• 检查项目最低部署版本
  • NSViewRepresentable最低支持macOS 10.15，低于该版本SwiftUI未开放AppKit集成接口
  • 进入项目设置 → 选中对应macOS Target → General标签页
  • 确认Minimum Deployments下的macOS版本≥10.15
• 核对Swift语言版本配置
  • SwiftUI的AppKit集成特性需要Swift 5.1及以上版本支持
  • 进入项目设置 → 对应Target → Build Settings标签页
  • 搜索Swift Language Version，确保设置为Swift 5或更高，过低的Swift版本无法解析NSViewRepresentable关联的泛型类型（如Context）
• 清理Xcode损坏缓存
  • 旧项目缓存索引损坏是“同代码新项目正常、旧项目报错”的常见诱因
  • 操作步骤：
    1. 菜单栏点击Product → Clean Build Folder（快捷键⇧⌘K）
    2. 关闭Xcode，打开Finder按⇧⌘G，输入路径~/Library/Developer/Xcode/DerivedData
    3. 删除对应项目名称的缓存文件夹，重启Xcode等待索引完成即可

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