Swift 3（Mac平台）：NSImageView加载GIF无显示求助

嗨，我之前也踩过NSImageView加载GIF的坑！默认的NSImageView其实只支持静态图片，它没法自动解析并播放GIF的动画帧——这就是为啥你换PNG能正常显示，但GIF啥都出不来的原因。下面给你两种实用的实现方式，你可以根据自己的需求选：

方法一：用NSAnimation快速实现GIF播放 #

这种方式适合不需要精细控制播放逻辑的简单场景，代码量少，上手快：

1. 先从GIF文件中提取所有帧：

guard let gifURL = Bundle.main.url(forResource: "your-gif-filename", withExtension: "gif"),
      let gifData = try? Data(contentsOf: gifURL),
      let imageSource = CGImageSourceCreateWithData(gifData as CFData, nil) else {
    print("GIF文件加载失败")
    return
}

let frameCount = CGImageSourceGetCount(imageSource)
var gifFrames: [NSImage] = []
for frameIndex in 0..<frameCount {
    guard let cgImage = CGImageSourceCreateImageAtIndex(imageSource, frameIndex, nil) else { continue }
    let nsImage = NSImage(cgImage: cgImage, size: NSZeroSize)
    gifFrames.append(nsImage)
}

2. 创建NSAnimation来切换NSImageView的显示内容：

let gifAnimation = NSAnimation(duration: 1.0, animationCurve: .linear) { [weak self] progress in
    let currentFrameIndex = Int(progress * Double(gifFrames.count)) % gifFrames.count
    self?.yourImageView.image = gifFrames[currentFrameIndex]
}
gifAnimation.repeatCount = 0 // 0代表无限循环
gifAnimation.start()

提示：duration参数是整个GIF循环一次的时长，你可以根据GIF的实际帧率调整，比如10帧/秒的GIF，10帧的话设为1.0就刚好匹配原速度。

方法二：用ImageIO+Timer精准控制播放 #

如果需要控制播放/暂停、按原GIF帧率播放，或者自定义循环逻辑，这种方式更灵活：

1. 先定义一个GIF播放管理类，封装加载和播放逻辑：

class GIFPlayer {
    private var timer: Timer?
    private var currentFrameIndex = 0
    private var frames: [NSImage] = []
    private var frameDelays: [TimeInterval] = []
    private weak var targetImageView: NSImageView?
    
    init(imageView: NSImageView, gifURL: URL) {
        targetImageView = imageView
        loadGIFContent(from: gifURL)
    }
    
    private func loadGIFContent(from url: URL) {
        guard let gifData = try? Data(contentsOf: url),
              let imageSource = CGImageSourceCreateWithData(gifData as CFData, nil) else { return }
        
        let frameCount = CGImageSourceGetCount(imageSource)
        for frameIndex in 0..<frameCount {
            // 提取帧图像
            guard let cgImage = CGImageSourceCreateImageAtIndex(imageSource, frameIndex, nil) else { continue }
            let nsImage = NSImage(cgImage: cgImage, size: NSZeroSize)
            frames.append(nsImage)
            
            // 提取原GIF的帧延迟时间（保证播放速度和原GIF一致）
            guard let properties = CGImageSourceCopyPropertiesAtIndex(imageSource, frameIndex, nil) as? [CFString: Any],
                  let gifProps = properties[kCGImagePropertyGIFDictionary] as? [CFString: Any],
                  let delay = gifProps[kCGImagePropertyGIFDelayTime] as? TimeInterval else {
                frameDelays.append(0.1) // 默认0.1秒每帧
                continue
            }
            frameDelays.append(delay)
        }
    }
    
    func startPlaying() {
        timer?.invalidate()
        currentFrameIndex = 0
        showCurrentFrame()
        scheduleNextFrame()
    }
    
    func stopPlaying() {
        timer?.invalidate()
        timer = nil
    }
    
    private func showCurrentFrame() {
        targetImageView?.image = frames[currentFrameIndex]
    }
    
    private func scheduleNextFrame() {
        guard currentFrameIndex < frameDelays.count else {
            currentFrameIndex = 0 // 循环播放
            scheduleNextFrame()
            return
        }
        let delay = frameDelays[currentFrameIndex]
        timer = Timer.scheduledTimer(withTimeInterval: delay, repeats: false) { [weak self] _ in
            self?.currentFrameIndex += 1
            self?.showCurrentFrame()
            self?.scheduleNextFrame()
        }
    }
}

2. 使用时只需要初始化并启动播放：

guard let gifURL = Bundle.main.url(forResource: "your-gif", withExtension: "gif") else { return }
let player = GIFPlayer(imageView: yourImageView, gifURL: gifURL)
player.startPlaying()

额外注意事项 #

• 记得在视图销毁或者不需要播放时，调用stopPlaying()或者销毁Timer，避免内存泄漏；
• 如果是从网络加载GIF，一定要在后台线程加载数据，再回到主线程更新UI；
• 确认你的GIF文件已经正确加入项目Bundle，文件名拼写要准确（macOS系统区分文件名大小写）。

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