ebiten 不适合做命令行音乐播放器，因其本质是游戏引擎，依赖图形渲染循环，启动即强制初始化 opengl/directx 上下文，即使仅播放音频也会报错或阻塞；而命令行场景无需窗口、事件循环，更应选用专注音频 i/o 的轻量库如 beep。
为什么 github.com/hajimehoshi/ebiten 不适合做命令行音乐播放器
它本质是游戏引擎，依赖 OpenGL / DirectX 渲染循环，启动时强制初始化图形上下文，即使你只播音频也会报 failed to initialize GLFW: No such file or directory 或卡在 ebiten.RunGame。命令行场景下，没窗口、没事件循环、不希望阻塞 stdin，用它等于给螺丝刀装发动机。
- 真正轻量的音频播放只需解码 + 输出，和图形渲染无关
- 若坚持用 Ebiten，必须开隐藏窗口、接管音频流、手动管理生命周期——复杂度远超需求
- 更合适的选择是专注音频 I/O 的库，比如
github.com/faiface/beep
beep 播放 MP3 文件的最小可行代码长什么样
它不内置 MP3 解码，需组合 github.com/faiface/beep/mp3；也不自动处理采样率转换，直接丢给扬声器可能无声或爆音。以下是最简但可运行的片段：
package main
import (
"os"
"github.com/faiface/beep"
"github.com/faiface/beep/speaker"
"github.com/faiface/beep/mp3"
)
func main() {
f, _ := os.Open("song.mp3")
streamer, format, _ := mp3.Decode(f)
defer streamer.Close()
speaker.Init(format.SampleRate, format.SampleRate.N(time.Second/10), 2)
speaker.Play(streamer)
select {} // 阻塞，等播完（实际应监听 Done 通道）
}
-
speaker.Init的第二个参数是缓冲区大小，太小（如format.SampleRate.N(time.Millisecond*10)）会导致卡顿 - MP3 文件若含 ID3v2 标签，
mp3.Decode可能读到非音频数据开头，建议先用io.Seeker跳过（或用github.com/mikkyang/id3-go预处理） - 别漏掉
defer streamer.Close()，否则文件句柄泄漏
如何让播放器响应 Ctrl+C 并优雅停止
beep 本身不提供播放控制 API，speaker.Play 是 fire-and-forget 式提交流；停止靠的是替换当前流为静音流，或关闭 speaker。常见错误是直接 os.Exit(0)，导致音频设备未释放、后续播放失败。
- 用
speaker.Replace切换为beep.Callback返回 0 样本的静音流，比杀进程干净 - 监听
os.Interrupt信号后，先调speaker.Clear()清空队列，再speaker.Close() - 注意：关闭 speaker 后不能再调
Play，如需重播得重新Init
WAV 和 FLAC 支持需要额外引入哪些包
beep 生态按格式拆包，不是“装一个就全支持”：
立即学习“go语言免费学习笔记（深入）”；
- WAV：
github.com/faiface/beep/wav，自带解码，无需额外依赖 - FLAC：
github.com/rakyll/portaudio是底层音频驱动，但解码需github.com/eaburns/flac或github.com/mjibson/go-dsp/flac（后者更轻，但仅支持无压缩 FLAC） - Ogg/Vorbis：
github.com/faiface/beep/vorbis，但注意其Decode返回的Format采样率可能是 48kHz，而 speaker 默认初始化为 44.1kHz，必须显式匹配，否则变调
所有格式最终都要转成 beep.Streamer 接口，统一交给 speaker。别指望自动重采样——beep.Resample 是可选中间件，不用就自己扛格式差异。
