Go image/gif.DecodeAll 怎么读取动画每帧的延迟时间

如果只调用 gif.Decode，拿到的只是 GIF 中的第一帧；要读取动画的每帧图像和停留时间，应调用 gif.DecodeAll。它返回一个 *gif.GIF，其中 Image[i] 与 Delay[i] 按同一个帧下标对应，延迟值的单位是百分之一秒，所以 8 表示 0.08 秒。

官方地址：https://pkg.go.dev/image/gif

读取动画元数据的关键不是把 GIF 当成多张独立图片打开，而是一次 DecodeAll 后同时遍历 Image、Delay，并把 LoopCount 当作播放策略单独处理。

• 首帧：Decode 只返回第一张嵌入图像。
• 逐帧：DecodeAll 返回全部帧和对应延迟。
• 换算：time.Duration(delay) * 10 * time.Millisecond 可把百分之一秒转成 Go 的时间类型。

为什么 Decode 读不到动画的后续帧

我第一次处理 GIF 时，最容易误判的是“解码成功但动画只有一张图”。这通常不是 GIF 丢帧，而是入口选成了 Decode。标准库文档把两者职责分得很清楚：Decode 读取第一张嵌入图像，DecodeAll 才读取连续帧和计时信息。

因此，需求只涉及封面预览时可以用 Decode；需要生成时间轴、统计总时长或逐帧处理时，则要选择 DecodeAll。两者都不是像素重采样工具，本文只讨论读取结果。

动手验证：先读尺寸，再回到文件开头

对外部上传的 GIF，不建议一上来就无条件保留所有帧。可以先用 DecodeConfig 读取逻辑屏幕尺寸，超过业务预算就拒绝；确认尺寸后把文件指针移回开头，再交给 DecodeAll。下面的限制是示例策略，不是 GIF 格式本身的固定上限。

package main

import (
    "fmt"
    "image/gif"
    "io"
    "os"
    "time"
)

func readGIF(path string) (*gif.GIF, error) {
    f, err := os.Open(path)
    if err != nil {
        return nil, fmt.Errorf("打开 GIF: %w", err)
    }
    // 文件句柄由本函数创建，读取完成后立即释放。
    defer f.Close()

    cfg, err := gif.DecodeConfig(f)
    if err != nil {
        return nil, fmt.Errorf("读取 GIF 尺寸: %w", err)
    }
    // 这里的尺寸预算是业务保护线，避免无界输入占用过多内存。
    if cfg.Width > 4096 || cfg.Height > 4096 {
        return nil, fmt.Errorf("GIF 尺寸超过业务上限: %dx%d", cfg.Width, cfg.Height)
    }
    if _, err := f.Seek(0, io.SeekStart); err != nil {
        return nil, fmt.Errorf("回到 GIF 开头: %w", err)
    }
    all, err := gif.DecodeAll(f)
    if err != nil {
        return nil, fmt.Errorf("读取 GIF 全部帧: %w", err)
    }
    return all, nil
}

func delayOf(ticks int) time.Duration {
    // Delay 的一个单位是 1/100 秒，换成 Go 的时间类型。
    return time.Duration(ticks) * 10 * time.Millisecond
}

func main() {
    g, err := readGIF("input.gif")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Printf("frames=%d loop=%d\\n", len(g.Image), g.LoopCount)
    for i, frame := range g.Image {
        // 同一个下标同时定位图像和延迟，避免错配帧时间。
        fmt.Printf("frame=%d size=%v delay=%s\\n", i, frame.Bounds().Size(), delayOf(g.Delay[i]))
    }
}

这里把文件复位是必要的：DecodeConfig 已经从 Reader 读取了 GIF 头部，不复位就直接调用 DecodeAll，后者看到的不是完整文件。若输入来自可重复读取的字节缓冲区，也可以在两次解码前重新创建 Reader。

Delay 和 LoopCount 应该怎样解释

g.Image 是逐帧图像切片，g.Delay 是逐帧延迟切片，两者按位置对应。不要把 Delay 直接当作毫秒：它的单位是百分之一秒，换算成毫秒要乘以 10。若只想统计总播放时长，可以把所有 Delay 换算后累加，但这仍然只是 GIF 帧时间的总和，不代表播放器一定没有额外调度误差。

LoopCount 与某一帧没有下标关系，它描述整段动画的循环策略：0 表示无限循环，-1 表示每帧只显示一次，其他非负值表示动画额外重复的次数。业务代码应把它与逐帧 Delay 分开保存，避免把循环次数误认为最后一帧的等待时间。

修复方案：先明确全部帧的内存代价

DecodeAll 会为每帧保留调色板图像，因此帧数、宽高和每帧内容共同决定内存压力。它适合中小型动画的元数据读取；如果输入来自不可信来源，先检查尺寸只是第一道业务约束，还应根据文件大小、帧数和并发量设置整体预算。

如果任务只需要首帧缩略图，就不必为了读取延迟而保留全部帧；如果确实需要逐帧处理，则要在业务层限制输入尺寸和并发。示例中的错误、尺寸上限和文件名都是参考实现，不表示已经在本机运行，也不应被当作所有业务都适用的安全阈值。

常见问题

为什么 len(g.Image) 和 len(g.Delay) 应该一起看？

因为它们都按帧下标组织，Image[i] 与 Delay[i] 才是同一帧的图像和停留时间。业务代码应避免只遍历其中一个切片。

Delay 的 5 是 5 毫秒吗？

不是。标准库中的一个 Delay 单位是百分之一秒，5 应换算为 0.05 秒，也就是 50 毫秒。

LoopCount 为 0 是不播放吗？

不是。对 gif.GIF 来说，0 表示无限循环；-1 表示每帧只显示一次，其他非负值表示额外重复次数。

可以先 DecodeConfig 再 DecodeAll 吗？

可以，但两次读取之间要让 Reader 回到文件开头，或重新创建一个 Reader。否则第二次解码可能从文件中间开始。

这篇的判断可以收束为三点：动画用 DecodeAll，帧时间看 Delay，播放次数看 LoopCount；面对外部 GIF 时，再把尺寸、帧数与全部帧内存纳入同一组输入边界。