SwiftUI自定义图片视图：本地资源与SF Symbols加载问题排查

1. 解决「No such module 'UIKit'」错误 #

这个错误是因为你在 macOS 平台下尝试导入仅适用于 iOS/tvOS/watchOS 的 UIKit 框架。要实现跨平台兼容，需使用条件编译区分不同平台的图片类：

import SwiftUI

// 条件导入平台特定框架并实现资源存在性检查
#if os(iOS) || os(tvOS) || os(watchOS)
import UIKit
private func assetExists(named name: String) -> Bool {
    return UIImage(named: name) != nil
}
#elseif os(macOS)
import AppKit
private func assetExists(named name: String) -> Bool {
    return NSImage(named: NSImage.Name(name)) != nil
}
#endif

2. 解决视图修饰符不支持的问题 #

你的自定义视图是 View 类型而非 Image 类型，因此无法直接应用 Image 专属修饰符（如 .resizable()、.scaledToFit()）。最简单的解决方案是创建返回 Image 的辅助函数：

func priorityImage(_ name: String) -> Image {
    if assetExists(named: name) {
        return Image(name)
    } else {
        return Image(systemName: name)
    }
}

使用方式 #

现在你可以像使用普通 Image 一样调用该函数，并直接应用所有 Image 修饰符：

priorityImage("my_local_icon")
    .resizable()
    .scaledToFit()
    .frame(width: 40, height: 40)
    .foregroundColor(.blue)

可选：保持自定义 View 结构体的方案 #

如果你仍想使用自定义 View 结构体，可通过内部封装 Image 并手动传递修饰符实现，但需要额外代码：

struct PriorityImage: View {
    let name: String
    private var image: Image {
        assetExists(named: name) ? Image(name) : Image(systemName: name)
    }
    
    init(_ name: String) {
        self.name = name
    }
    
    var body: some View {
        image
    }
    
    // 封装常用 Image 修饰符
    func resizable(capInsets: EdgeInsets = EdgeInsets(), resizingMode: Image.ResizingMode = .stretch) -> some View {
        image.resizable(capInsets: capInsets, resizingMode: resizingMode)
    }
    
    func scaledToFit() -> some View {
        image.scaledToFit()
    }
    
    // 根据需求添加更多修饰符...
}

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