ogg是容器格式，不定义编解码器；解析前必须用ogginfo确认内部流类型（如vorbis/opus），再搭配对应解码库（libvorbis或libopus），libogg仅负责解复用，无法单独输出pcm。
OGG不是单一格式，而是容器——解析前必须确认内部编解码器
OGG本身不定义音频/视频编码方式，只是封装框架。直接“解析OGG”没有意义，你真正要处理的是 vorbis、opus、theora 或 flac（虽然FLAC常独立使用，但也有OGG封装变体）等流。libogg 只负责解复用（demux），不负责解码。如果跳过这一步就写解析逻辑，大概率读到的是一堆无法解释的 ogg_packet 二进制块。
实操建议：
- 先用
ogginfo命令行工具检查文件：ogginfo track.ogg，看输出里明确写着Processing file "track.ogg"... Stream #0: vorbis还是Opus - 若为
vorbis，后续必须接libvorbis；若为opus，必须用libopus；混用会导致ov_open_callbacks成功但ov_read返回负值 - 不要自己解析 OGG page header（如
0x4f676753魔数），libogg 已稳定处理字节对齐、校验和、continuation 标志等边界情况
用 libogg + libvorbis 解析 Vorbis 流的最小可行路径
这是最常见组合。核心流程是：打开 → 定位音频流 → 获取声道/采样率信息 → 循环读帧。libvorbis 提供的 ov_open 实际已内嵌 libogg 调用，无需手动管理 ogg_stream_state。
关键点：
-
ov_open失败常见原因是文件非 seekable（如网络流），此时改用ov_open_callbacks并提供自定义read_func和seek_func -
ov_info返回的channels和rate是最终解码参数，不是 OGG header 里的原始字段；Vorbis comment header（如 artist/title）需用ov_comment - 每次
ov_read返回的是 PCM 数据（short 或 float，取决于编译选项），长度不固定——Vorbis 帧长可变，不能假设每次读 1024 样本 - 务必检查返回值：
ov_read返回0表示流结束，负数表示错误（如OV_HOLE表示丢包，OV_EBADLINK表示流索引错乱）
Opus in OGG 需用 libopus，libvorbis 完全无效
Opus 使用 OGG 封装时，page structure 和 packet layout 与 Vorbis 不同，libvorbis 的 ov_* 函数会直接拒绝识别或触发断言失败。必须切换工具链。
实操要点：
- 用
op_open_file替代ov_open，它返回OggOpusFile*；错误码是OP_FALSE/OP_EOF等，不是OV_*系列 -
op_pcm_total获取总样本数，op_head获取OpusHead结构（含预跳 sample 数pre_skip，必须从解码输出中裁掉） - Opus 默认输出 float PCM，若需 int16，调用
op_read_stereo或op_read_float后自行转换，别依赖 libogg 做类型适配 - 注意 Opus OGG 的 BOS（Beginning Of Stream）page 必须紧随第一个
OpusHeadpacket，某些转码器生成的非法文件会导致op_open_file返回OP_ENOTFORMAT
跨平台构建时，pkg-config 和链接顺序极易出错
Linux/macOS 下用 pkg-config --libs --cflags vorbisfile opusfile ogg 看到的顺序，不代表链接时能随便排。libvorbisfile 依赖 libvorbis 和 libogg，libopusfile 依赖 libopus 和 libogg，但 libogg 不能放在最后。
典型错误命令：
g++ -o player main.cpp `pkg-config --cflags vorbisfile` -lvorbisfile -lvorbis -logg
正确写法（依赖关系从右往左）：
g++ -o player main.cpp `pkg-config --cflags vorbisfile` -lvorbisfile -lvorbis -logg
更稳妥的方式是显式分组：
g++ -o player main.cpp `pkg-config --cflags vorbisfile` -Wl,--no-as-needed -lvorbisfile -lvorbis -logg -Wl,--as-needed
Windows 上 MinGW 链接 libvorbis_file.dll.a 时，若漏掉 libvorbis.dll.a 和 libogg.dll.a，运行时报 undefined reference to `_imp__ov_open' —— 这不是头文件问题，是链接器根本没看到符号定义。
OGG 解析真正的复杂点不在代码量，而在流类型判定和库依赖的隐式耦合。一个 .ogg 文件可能在一台机器上被 libvorbis 正确打开，在另一台因安装了 libopus 但没装 libvorbis 就彻底失败——这时候报错往往不是 “unsupported format”，而是 “invalid stream”，容易误判为文件损坏。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
