Go go-mp3 解码器是否负责向音频设备播放声音

不负责。go-mp3 的 Decoder 只负责把 MP3 输入解码成 PCM 字节流，调用方还要把这些 PCM 数据交给另一个音频输出后端，才能听到声音。把“解码成功”和“设备播放成功”当成同一件事，是 Go 音频程序出现“读取有数据但没有声音”时最常见的误判。

官方地址：https://pkg.go.dev/github.com/hajimehoshi/go-mp3

先把“能解码”和“能播放”拆成两条链路

一个音频程序至少有两个职责边界：输入侧读取 MP3 文件或网络流，解码器将压缩帧转换成线性 PCM；输出侧再把 PCM 按目标设备支持的格式送入声卡、系统音频服务或其他播放库。go-mp3 位于中间的解码位置，它的 README 将自己定位为纯 Go MP3 decoder，API 也围绕 NewDecoder、Read、SampleRate 和 Seek 展开。

因此，下面的调用只能证明“解码器可以产生 PCM 数据”，不能证明系统已经开始播放：

package main

import (
    "fmt"
    "io"
    "os"

    "github.com/hajimehoshi/go-mp3"
)

func main() {
    f, err := os.Open("demo.mp3")
    if err != nil {
        // 输入文件打不开时，播放链路还没有开始。
        panic(err)
    }
    defer f.Close() // 文件句柄只属于输入侧，及时释放。

    decoder, err := mp3.NewDecoder(f)
    if err != nil {
        // 这里处理的是 MP3 解码初始化错误，不是声卡错误。
        panic(err)
    }

    fmt.Println("sample rate:", decoder.SampleRate())
    buf := make([]byte, 4096)
    n, err := decoder.Read(buf)
    if err != nil && err != io.EOF {
        // Read 成功只代表拿到 PCM；设备仍未收到这段数据。
        panic(err)
    }
    fmt.Println("decoded PCM bytes:", n)
}

这个例子没有导入声卡包，也没有把 buf[:n] 写给音频设备，所以它的正确结论是“拿到了 PCM”，而不是“播放了声音”。

Decoder 输出的格式决定播放端怎么配置

官方 API 文档明确说明，NewDecoder 返回的流总是 16 位小端双声道，即使源 MP3 是单声道也会按双声道输出；一个采样包含 4 个字节。SampleRate 返回从第一帧取得的采样率，例如 44100。播放后端必须按这些信息初始化，否则可能出现速度不对、噪声、左右声道异常或直接拒绝写入。

可以把解码器看成一个实现了 io.Reader 的 PCM 生产者，再由独立的播放器消费它：

type PCMFormat struct {
    SampleRate int
    Channels   int
    BitDepth   int
    LittleEnd  bool
}

func decodeFormat(decoder *mp3.Decoder) PCMFormat {
    // go-mp3 的输出契约是 16 位、小端、双声道。
    return PCMFormat{
        SampleRate: decoder.SampleRate(),
        Channels:   2,
        BitDepth:   16,
        LittleEnd:  true,
    }
}

func pumpPCM(decoder io.Reader, player io.Writer) error {
    buf := make([]byte, 32*1024)
    for {
        // 播放端应消费本次实际读取的 n 个字节，而不是整个缓冲区。
        n, readErr := decoder.Read(buf)
        if n > 0 {
            if _, err := player.Write(buf[:n]); err != nil {
                // 这里才是输出设备或播放后端的写入错误。
                return err
            }
        }
        if readErr == io.EOF {
            return nil // PCM 已读完，播放端可按自身协议收尾。
        }
        if readErr != nil {
            return readErr // 保留解码读取错误，避免静默丢帧。
        }
    }
}

示例中的 player 只是抽象的 io.Writer，用于表达职责分工；真实程序需要选择能打开目标系统音频设备的播放库，并确认它接受 16 位小端双声道 PCM。不能因为示例能写入一个普通文件，就推断声音已经从扬声器输出。

没有声音时沿四个边界排查

遇到“程序没有报错但没有声音”，不要先修改 MP3 解码器。按下面的边界分别确认：

另外，Seek 使用的是字节偏移，文档提醒样本按 4 字节对齐；如果做进度跳转，应让偏移落在完整采样边界上。Length 在底层输入不是 io.Seeker 时可能返回 -1，这也只是长度信息不可得，不代表音频设备不可用。

结论：让 go-mp3 解码，让播放后端输出

可以用一句话记住职责：go-mp3 负责压缩音频到 PCM 的转换，播放库或系统音频服务负责把 PCM 送到设备。设计代码时，把 Decoder、PCM 格式描述和播放器接口分开，先确认解码读取正常，再确认播放端配置与写入正常，问题就能快速定位。

常见问题

go-mp3 能不能直接调用电脑扬声器？

不能。它提供的是解码器和读取接口，不提供打开声卡、选择设备或控制音量的播放 API。

单声道 MP3 会输出单声道 PCM 吗？

官方文档说明输出始终是 16 位小端双声道，因此播放端不能简单按输入文件的原始声道数推断解码结果。

Read 返回数据后直接丢弃可以吗？

如果目标只是探测能否解码，可以读取后丢弃；如果要播放，必须把实际返回的 n 个字节交给配置匹配的播放后端。