如何检查Image(systemName:)初始化器的指定systemName对应图片是否可正常渲染？

核心思路 #

直接尝试通过systemName初始化图片对象，判断返回结果是否为nil——系统不存在对应图标时，初始化会失败返回nil，以此作为显示占位图的依据。

代码实现（Swift） #

通用检查函数

func isSystemImageAvailable(systemName: String) -> Bool {
    return UIImage(systemName: systemName) != nil
}

实际使用示例

SwiftUI场景

struct IconView: View {
    let targetIconName = "custom-system-icon"
    
    var body: some View {
        Group {
            if isSystemImageAvailable(systemName: targetIconName) {
                Image(systemName: targetIconName)
                    .font(.title)
            } else {
                Image("placeholder-icon") // 本地占位图
                    .resizable()
                    .scaledToFit()
                    .frame(width: 24, height: 24)
            }
        }
    }
}

UIKit场景

func setupIconImageView() {
    let imageView = UIImageView(frame: CGRect(x: 20, y: 20, width: 24, height: 24))
    let targetIconName = "custom-system-icon"
    
    if let systemImage = UIImage(systemName: targetIconName) {
        imageView.image = systemImage
    } else {
        imageView.image = UIImage(named: "placeholder-icon")
    }
    
    view.addSubview(imageView)
}

注意事项 #

• 该判断是同步操作，性能开销极低，无需异步处理
• SF Symbols的图标集随iOS版本迭代更新，部分新图标仅在高版本系统可用（比如iOS 15+新增的图标），旧系统会返回nil，需注意版本兼容性
• 若你使用的是自定义注册的系统图标（而非官方SF Symbols），该方法同样有效，只要系统能识别到对应systemName就会返回有效图片对象

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