macCatalyst无法识别带设备变体的Asset Catalog图片问题求助

问题情况 #

我的Asset Catalog里的图片资源，只要添加了设备变体（比如iPad、macCatalyst或Mac的替代图），macCatalyst就找不到该资源，但iOS和iPadOS完全正常。删掉所有变体后图片能正常显示，一旦加回变体就又无法识别。

相关代码片段：

struct MyView: View {
    var body: some View {
        //图片名称与截图中的不同
        Image("myimage")
    }
}

无变体时图片正常显示：

添加任意变体后图片无法识别：

其他开发者的反馈与解决思路 #

不少开发者都碰到过这个macCatalyst的资源变体兼容性问题，以下是几个验证有效的解决方法：

• 改用命名后缀替代Asset Catalog变体：放弃使用Asset Catalog的设备变体功能，直接给图片文件添加平台后缀，比如myimage~mac.png，代码里依旧用Image("myimage")，系统会自动匹配对应平台的资源文件。
• 拆分资源目录：单独为macCatalyst创建一个Asset Catalog，把mac专属图片放进去，在Build Settings里仅让macCatalyst目标勾选这个目录，iOS/iPadOS目标不勾选。
• 检查编译设置与目标归属：确认macCatalyst目标的Asset Catalog Compiler - Options中，Device Specific Resources设为YES；同时检查变体图片的Target Membership是否已经勾选了macCatalyst目标。
• 清理缓存后重建：执行Product > Clean Build Folder，手动删除DerivedData目录，再重新编译运行macCatalyst项目，缓存异常也可能导致资源识别失败。

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