Golang调用FFmpeg提取视频信息教程

本文深入讲解了在 Go 语言中通过 exec.Command 安全、高效调用 ffmpeg 提取视频元信息（如时长、分辨率、码率等）的完整实践方案，涵盖环境准备、命令构造、JSON 输出解析、超时与进程管理、Windows 路径及编码适配等关键细节，直击常见坑点——从 PATH 缺失、stderr 被忽略、进度条污染输出，到带点字段解析失败、孤儿进程残留、中文路径乱码，并给出可落地的结构体定义、context 超时控制、跨平台进程清理等硬核解决方案，帮你绕过重复踩坑，真正用好 ffmpeg 这个“外部瑞士军刀”。

用 exec.Command 调用 ffmpeg 提取视频时长、分辨率等元信息

直接调用 ffmpeg 命令是最轻量、最可靠的方式——Go 自身不内置视频解析能力，硬啃 MP4/AVI 容器结构得不偿失。关键不是“能不能”，而是命令怎么拼、输出怎么收、错误怎么判。

常见错误现象：exec: "ffmpeg": executable file not found in $PATH（没装 ffmpeg 或不在 PATH）；exit status 1 却没打印 stderr（忽略错误流）；输出里混着进度条和警告（没加 -v quiet）。

• 必须用 -v quiet -print_format json -show_entries 控制输出格式，避免解析非结构化文本
• 推荐加 -sexagesimal 会把时长转成 00:01:23.456 格式，但 JSON 模式下它无效，得用 -show_entries format=duration + 自己转秒
• 如果只要基础信息（时长、宽高、码率），用 format 和 streams 就够了，别 -show_entries stream=all —— 输出爆炸且慢

解析 ffmpeg 的 JSON 输出到 Go struct

ffmpeg 的 -print_format json 输出是合法 JSON，但字段名带点（如 streams.0.width），标准 json.Unmarshal 不认。不能靠字符串切分，也不能手动写 map[string]interface{} 嵌套解析。

正确做法是：先定义结构体，用 json:"streams" 对应顶层 key，再嵌套 slice 或 struct。注意 streams 是数组，哪怕只有一路视频流。

type FFProbeResult struct {
	Format struct {
		Duration string `json:"duration"`
		BitRate  string `json:"bit_rate"`
	} `json:"format"`
	Streams []struct {
		CodecType string `json:"codec_type"`
		Width     int    `json:"width"`
		Height    int    `json:"height"`
	} `json:"streams"`
}

• Duration 是字符串（单位秒，含小数），不是 float64——ffmpeg 输出带精度，比如 "123.456000"，直接转 float 可能丢精度，建议用 strconv.ParseFloat 按需处理
• 如果视频没有视频流（只有音频），Width/Height 字段不会出现，struct 字段要设默认零值或用指针 *int 配合 omitempty
• 别用 map[string]interface{} 解析——类型丢失、易 panic、无法静态检查

超时控制和子进程僵死问题

ffmpeg 分析大文件（尤其高清 MKV）可能卡住，Go 默认不设超时，cmd.Run() 会一直挂起。更糟的是，如果父进程崩溃而 ffmpeg 还在跑，它就成孤儿进程继续吃 CPU。

• 必须用 context.WithTimeout 包裹 cmd.Start() 和 cmd.Wait()，超时后调用 cmd.Process.Kill()
• 别只依赖 cmd.Run() 的 timeout——它只管启动阶段，实际执行中卡死仍无响应
• Windows 下 Kill() 可能不彻底，加个 defer os.RemoveAll(tempDir) 清理临时文件（如果用了 -i 重定向输入）
• 用 cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}（Linux/macOS）可确保 kill 时连同子进程一起干掉

Windows 下路径空格和编码问题

用户传入的视频路径含中文或空格（如 C:\我的视频\test.mp4），直接拼进 exec.Command("ffmpeg", "-i", path, ...) 会失败——Windows cmd 解析参数时把空格当分隔符，ffmpeg 收到的路径被截断。

• 不用自己加引号！exec.Command 参数是字符串切片，每个元素独立传递，操作系统不走 shell 解析，所以 exec.Command("ffmpeg", "-i", "C:\\我的视频\\test.mp4") 安全
• 但 Windows 控制台默认 GBK 编码，ffmpeg stderr 输出中文（如“无法打开”）会乱码；解决方案：改用 chcp 65001 切 UTF-8，或干脆忽略 stderr 中文内容，只信 JSON stdout
• 路径不要用正斜杠 / 混用（虽然 Go runtime 通常兼容），统一用双反斜杠 \\ 或 raw string `C:\my\video.mp4`

真正麻烦的是容器格式异常、损坏文件、ffmpeg 版本差异导致字段缺失——这些没法靠代码兜底，得靠日志记录原始 ffmpeg 输出，方便回溯。

理论要掌握，实操不能落！以上关于《Golang调用FFmpeg提取视频信息教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！