Go flac 怎样读取FLAC的STREAMINFO元数据

Go 读取 FLAC 的 STREAMINFO，最小做法是调用 flac.Open 或 flac.ParseFile，然后从返回的 stream.Info 取字段。只想拿采样率、声道数、位深和总采样数时，flac.Open 已经够用；还要查看 VorbisComment、SeekTable 等其它 metadata 时，再用 flac.ParseFile。

官方地址：https://pkg.go.dev/github.com/mewkiz/flac

STREAMINFO 是 FLAC 流中必需且位于首个 metadata block 的基础描述。工程上应先选对解析入口，再把 Info 当作“媒体属性契约”读取，而不要把它误认为完整标签集合。

• 只读基础属性：使用 flac.Open，读取 stream.Info。
• 需要所有 metadata：使用 flac.ParseFile，同时查看 stream.Blocks。
• 资源管理：文件入口返回的流使用完后调用 defer stream.Close()。

把 STREAMINFO 当作媒体入口的最小契约

FLAC 文件先有固定签名，再有 metadata blocks，之后才是音频帧。STREAMINFO 描述采样率、声道、位深、总采样数、块大小、帧大小和未编码音频的 MD5；它是唯一必须存在的 metadata block。这个位置决定了一个实用模式：读取媒体基本属性时，不必为了得到一组数字而扫描所有标签。

为什么 ParseFile 是稳妥的典型实现

最小读取可以这样写。Open 会解析 FLAC 签名和 STREAMINFO，并跳过其它 metadata；如果使用 ParseFile，则会解析全部 metadata blocks。下面的写法只输出基础属性，并保留关闭流的责任。

package main

import (
    "fmt"
    "log"

    "github.com/mewkiz/flac"
)

func main() {
    // Open 只满足读取基础 StreamInfo 的需求，避免把目标扩大成完整标签扫描。
    stream, err := flac.Open("sample.flac")
    if err != nil {
        log.Fatal(err)
    }
    // 文件流使用完必须关闭，释放底层资源。
    defer stream.Close()

    info := stream.Info
    fmt.Printf("采样率: %d Hz\\n", info.SampleRate)
    fmt.Printf("声道数: %d\\n", info.NChannels)
    fmt.Printf("位深: %d bit\\n", info.BitsPerSample)
    fmt.Printf("总采样数: %d\\n", info.NSamples)
}

如果还要列出块类型，把入口替换为 flac.ParseFile，再遍历 stream.Blocks。这不是“更完整就永远更好”，而是用解析成本换取更大的信息面；只做媒体时长索引时，前一种模式更直接。

不要把 Info 当成完整元数据

stream.Info 的类型是 *meta.StreamInfo，字段名已经暴露了它的边界：SampleRate 是 Hz，NChannels 是声道数，BitsPerSample 是每个采样的位数，NSamples 是跨声道的总采样数。艺术家、专辑等键值标签属于其它 metadata block，不会凭空出现在 Info 里。

还要注意两个容易误读的值：NSamples == 0 表示总采样数未知；FrameSizeMin 或 FrameSizeMax == 0 表示对应帧大小未知。未知不等于文件损坏，应用应把它当作“暂时无法计算”的状态。

把读取结果变成可用的工程检查

读取后通常先做范围与可用性判断，再计算展示值。例如，时长可以用总采样数除以采样率，但必须先排除采样率为 0 或总采样数未知的情况；声道与位深则直接用于播放器或转码任务的能力判断。

import "github.com/mewkiz/flac/meta"

func durationSeconds(info *meta.StreamInfo) (float64, bool) {
    // 采样率或总采样数未知时，不返回一个看似精确的时长。
    if info == nil || info.SampleRate == 0 || info.NSamples == 0 {
        return 0, false
    }
    return float64(info.NSamples) / float64(info.SampleRate), true
}

上面的函数需要额外导入 github.com/mewkiz/flac/meta。如果应用只需要展示基本信息，可把 MD5 留作记录或后续完整性比对；如果要解析音频帧，则再进入 stream.Next 或 stream.ParseNext 的另一条职责链。

常见问题

Open 和 ParseFile 应该选哪个？

只读 STREAMINFO 选 Open；需要所有 metadata blocks 选 ParseFile。两者都返回 Stream，但解析范围不同。

为什么 NSamples 是 0？

官方字段说明把 0 定义为未知。展示时应保留未知状态，不要直接显示成零秒。

读取 Info 后还需要遍历 Blocks 吗？

只有当业务要读取评论、封面、SeekTable 等额外 metadata 时才需要。基础媒体属性不依赖遍历全部 Blocks。