VideoWriter 初始化失败主因是FFmpeg未正确链接或fourcc编码器不支持，需验证isOpened()、检查cv::getBuildInformation()中FFMPEG: YES，并确保release()调用。
VideoWriter 初始化失败：编码器不匹配或路径权限问题
直接用 cv::VideoWriter 写 MP4 失败，最常见的原因是 OpenCV 后端（通常是 FFmpeg）没正确链接，或者指定的 fourcc 编码器不被当前 OpenCV 构建所支持。Windows 上用 cv::VideoWriter::fourcc('m', 'p', '4', 'v') 或 'a', 'v', 'c', '1' 往往无效——前者不是标准 MP4 编码器标识，后者在多数预编译二进制中未启用。
实操建议：
- 优先用
cv::VideoWriter::fourcc('a', 'v', 'c', '1')（H.264），但必须确认你的 OpenCV 是用 FFmpeg 支持编译的；可通过cv::getBuildInformation()查看输出里是否含FFMPEG: YES - 路径必须可写，且父目录存在；
"output.mp4"不能写到C:\根目录（权限不足），也别用中文路径或空格（某些 FFmpeg 版本会崩） - 初始化后务必检查
writer.isOpened() == true，否则后续write()静默失败
帧尺寸和格式不匹配：保存黑屏或报错
VideoWriter 构造时传入的宽高必须与每一帧 Mat 的 .cols 和 .rows 完全一致，且通道数要匹配（MP4 通常只接受 BGR 或 GRAY）。如果处理过程中做了 resize、cvtColor 或 ROI 截取，但没同步更新 VideoWriter 参数，就会写入失败或输出黑屏。
实操建议：
- 构造
VideoWriter前，用处理后的首帧确认尺寸：frame.size()，不要复用原始视频的cap.get(cv::CAP_PROP_FRAME_WIDTH) - 确保帧是
CV_8UC3（BGR）或CV_8UC1（灰度）；若用了cvtColor(frame, frame, cv::COLOR_RGB2BGR)，必须在write()前完成 - 帧率（fps）建议设为整数（如 30.0），避免某些封装器对浮点帧率兼容性差
写入后文件无法播放：缺少 release() 或帧未及时 flush
很多用户调完 writer.write(frame) 就结束程序，结果生成的 MP4 打不开或只有几帧——这是因为 FFmpeg 缓冲区里的 GOP（关键帧组）还没写完，文件头也没最终封包。
实操建议：
- 循环结束后必须显式调用
writer.release()；它会触发 FFmpeg 刷盘、写索引、封文件头 - 如果中途异常退出（如 Ctrl+C），加
try/catch或 RAII 封装（例如用std::unique_ptr管理 writer） - 不建议在循环内频繁
release()/open()，开销大且易损坏文件
跨平台兼容性：Linux/macOS 下更推荐 avc1，Windows 可试 mp4v
不同系统 FFmpeg 默认行为有差异：macOS 的 OpenCV 官方包通常默认支持 avc1，Linux（尤其 Ubuntu apt 安装）也稳定；Windows 上部分 OpenCV 自带的 FFmpeg 不含 H.264 encoder，此时 mp4v（MPEG-4 Part 2）可能勉强可用，但画质差、兼容性弱。
实操建议：
- 开发阶段先打印
cv::getBuildInformation()，重点看Video I/O段落 - 实在不行，改用
.avi容器 +cv::VideoWriter::fourcc('X', 'V', 'I', 'D')（Windows）或'M', 'J', 'P', 'G'（跨平台），至少能保功能验证 - 生产环境需要可靠 MP4，建议自己编译 OpenCV 并启用系统 FFmpeg（
-D WITH_FFMPEG=ON -D FFMPEG_INCLUDE_DIRS=...）
最常被忽略的一点：OpenCV 的 VideoWriter 对 MP4 的支持不是“开箱即用”，它完全依赖底层 FFmpeg 的构建配置。不验证 isOpened()、不检查构建信息、不调 release()——这三个动作少一个，MP4 就大概率废掉。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
