SwiftUI预览无法显示自定义PNG图片，但App运行正常求助

问题背景 #

使用Adobe Illustrator制作自定义图片，导出为Leafy.png后添加到项目Asset Catalog，在SwiftUI视图中调用时仅显示图片框架，无内容显示。已验证图片本身无问题：在测试项目中使用该图片的.svg/.jpg格式均可正常显示。

关键现象：该问题仅出现在Xcode预览中，App实际运行（模拟器/真机）时图片可正常显示。

视图代码片段 #

var body: some View {
        VStack {
            TabView(selection: $currentPage) {
                // Page 0: Welcome Page
                VStack {
                    Spacer()
                    Text("Welcome to Nutrify")
                        .font(.custom("Anek Devanagari", size: 28).weight(.medium))
                        .foregroundColor(primaryColor)
                        .padding()
                    Image("Leafy")
                        .resizable()
                        .frame(width: 350, height: 350)
                    Text("We're glad to have you here!")
                        .font(.custom("Anek Devanagari", size: 20))
                        .foregroundColor(.secondary)
                        .padding(.horizontal)
                        .multilineTextAlignment(.center)
                    Spacer()
                    Button(action: {
                        nextPage()
                    }) {
                        Text("Next")
                            .font(.custom("Anek Devanagari", size: 20).weight(.medium))
                            .foregroundColor(colorScheme == .dark ? .white : .white)
                            .frame(maxWidth: .infinity)
                            .padding()
                            .background(buttonBackgroundColor)
                            .cornerRadius(13)
                    }
                    .padding([.horizontal, .bottom], 30)
                }
                .tag(0)
                .padding()

相关截图 #

原因分析 #

1. Xcode预览缓存不同步：预览模块的资源缓存独立于主项目构建缓存，当Asset资源更新时，预览可能未及时加载最新资源
2. 预览渲染引擎兼容性：Xcode预览的渲染引擎与App运行时的渲染引擎存在差异，部分AI导出的PNG（含特定透明通道、色彩空间）在预览中无法正常解析
3. Xcode版本bug：特定Xcode版本对AI导出PNG的预览解析存在已知兼容性问题

解决办法 #

• 清理构建缓存并刷新预览：执行Cmd+Shift+K清理Build Folder，关闭预览面板后重新打开，点击预览面板的刷新按钮
• 重新导入图片资源：删除Asset Catalog中的Leafy资源，重新拖拽导入，确保勾选"Copy items if needed"，并确认Target Membership已勾选当前项目目标
• 转换图片格式：将AI导出的PNG通过预览.app重新导出（选择sRGB色彩空间，按需取消Alpha通道），或改用已验证可行的SVG/JPG格式
• 升级Xcode：若使用旧版Xcode，升级到最新稳定版本修复已知兼容性bug
• 重启Xcode：强制重启Xcode，彻底重置预览模块的缓存状态

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