ffmpeg官方仅提供c接口，所谓“c++封装库”实为第三方非标准wrapper；调用需严格遵循c api生命周期，如avformat_open_input失败需检查路径、初始化及错误码转换，解码时avcodec_receive_frame返回eagain属正常流控，须循环送包与取帧。
不能直接用 C++ 调用 FFmpeg 的 C++ 封装库——FFmpeg 官方只提供 C 接口，所谓“FFmpeg_C++”不是标准组件，绝大多数情况下是误传或第三方薄封装，实际开发必须面对 C API。
为什么找不到 ffmpeg_cpp 或 FFmpeg::Decoder 这类头文件
FFmpeg 源码里没有 C++ 类、命名空间或模板封装。所有 avcodec_*、avformat_*、sws_scale 等函数全是 C 风格的 extern “C” 函数。所谓“C++ 教程”标题里的 C++ 通常仅指“在 C++ 项目里调用 FFmpeg”，而非“用 C++ 写的 FFmpeg”。
- 搜索
ffmpeg_cpp得到的 github 项目，基本是个人写的轻量 wrapper（如ffmpeg-cpp），不维护、不兼容新版本、不处理内存生命周期 - qt、opencv 等库自带的多媒体模块，底层仍是调用 FFmpeg C API，只是做了二次抽象
- 真正稳定的 C++ 音视频工程（如 OBS、MPV）都直接写 C 风格调用，靠 RAII 封装资源（如用
std::unique_ptr管理AVFormatContext*）
avformat_open_input 失败但没报错？检查这三件事
这是最常卡住的点：函数返回负值（如 -2），但 av_strerror 输出乱码或空字符串，实际是错误码没正确转成字符串。
- 确保传入的是有效路径，windows 下避免反斜杠未转义：
"C:video.mp4"或R"(C: ideo.mp4)"，不要写"C: ideo.mp4" - 调用前初始化：必须先调用
avformat_network_init()（哪怕只读本地文件，某些版本也依赖它） - 查错要配对用：
int ret = avformat_open_input(&fmt_ctx, url, nullptr, nullptr);→av_strerror(ret, errbuf, sizeof(errbuf))，不能直接打印ret
解码一帧视频，为什么 avcodec_receive_frame 总返回 EAGAIN
这不是错误，是 FFmpeg 流控机制的正常反馈：解码器输入缓冲区还没攒够数据，无法输出帧。新手常以为“卡住了”，其实是没循环喂包。
立即学习“C++免费学习笔记（深入）”；
- 典型流程必须是：循环
av_read_frame→ 判断stream_index→avcodec_send_packet→ 再循环avcodec_receive_frame直到返回0或AVERROR(EAGAIN) - 注意：一个
AVPacket可能触发多帧输出（尤其 B 帧场景），所以receive_frame必须用 while 包裹 - 如果始终
EAGAIN，大概率是没送任何 packet 进去，或送错了 stream（比如把音频 packet 送到视频解码器）
Windows 下链接失败：找不到 avcodec-60、avutil-58 等符号
FFmpeg 动态库名带版本号（如 avcodec-60.dll），但头文件声明的函数不带版本后缀，链接器找不到对应导出符号。
- 编译时用
-lavcodec -lavformat -lavutil即可，链接器会自动找avcodec-60.lib（Windows）或libavcodec.so.60（linux） - 运行时要把对应 DLL 放到 exe 同目录，或系统 PATH；别用 MinGW 自带的旧版 FFmpeg（版本太老，函数签名已变）
- 若用 vcpkg，安装命令是
vcpkg install ffmpeg:x64-windows，它会自动处理导入库和运行时 DLL 路径
真正的难点不在语法，而在状态机管理：每个 AVFormatContext、AVCodecContext 都有明确的生命周期，open/close、alloc/free、send/receive 的顺序和配对稍错一点，就会内存泄漏或段错误。没人能靠抄几行代码跑通全流程，必须对照官方 doc/examples/ 里的 demuxing_decoding.cpp 逐行理解资源流转。