3、文件信息探查：使用 ffprobe 查看媒体信息、分析流数据、常用探测参数

做音视频处理，第一件事是什么？不是转码，不是剪辑，而是——搞清楚你手里拿的是什么文件。

我见过太多人拿到一个视频就直接开转，结果码率不对、色彩空间错了、音频采样率不匹配，折腾半天才发现是源文件的问题。说白了，ffprobe 就是你的“媒体文件体检仪”。它能告诉你文件里到底藏着什么。

3.1 基础用法：先看个全貌

最简单的命令，直接看文件整体信息：

ffprobe input.mp4

输出会很长，包含文件格式、时长、比特率、元数据标签，以及每个流的详细信息。我个人习惯先跑这条命令，快速确认文件是不是“看起来正常”。

但默认输出太啰嗦了。如果你只想看关键信息，用 -hide_banner 去掉编译信息：

ffprobe -hide_banner input.mp4

嗯，清爽多了。只保留媒体相关的分析结果。

3.2 流数据分析：视频、音频、字幕各是什么来头？

一个媒体文件通常包含多个流（stream）。视频流、音频流、字幕流，甚至还有数据流。ffprobe 可以让你精确查看每个流。

查看所有流的概要：

ffprobe -hide_banner -show_streams input.mp4

输出格式是键值对，每个流用 [/STREAM] 分隔。你会看到类似这样的信息：

[STREAM]
index=0
codec_name=h264
codec_long_name=H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
profile=High
width=1920
height=1080
pix_fmt=yuv420p
duration=120.500000
bit_rate=5000000
[/STREAM]
[STREAM]
index=1
codec_name=aac
codec_long_name=AAC (Advanced Audio Coding)
sample_rate=48000
channels=2
[/STREAM]

这里 index=0 是视频流，index=1 是音频流。一眼就能看出：视频是 H.264、1080p、5Mbps；音频是 AAC、48kHz、立体声。

3.3 常用探测参数：精准定位问题

ffprobe 的参数很多，但日常工作中常用的就那么几个。我整理了一张表，你直接照着用就行。

参数	作用	示例
-show_format	显示容器格式信息（时长、总比特率、元数据）	ffprobe -show_format input.mp4
-show_streams	显示所有流的详细信息	ffprobe -show_streams input.mp4
-select_streams	选择特定流进行分析	ffprobe -select_streams v:0 -show_streams input.mp4
-show_packets	显示数据包信息（用于深度分析）	ffprobe -show_packets input.mp4
-show_frames	显示每一帧的信息（关键帧、PTS、DTS）	ffprobe -show_frames input.mp4
-print_format	指定输出格式（json、csv、flat 等）	ffprobe -print_format json input.mp4
-v quiet	只输出结果，不输出日志	ffprobe -v quiet -show_format input.mp4
-of	-print_format 的简写	ffprobe -of json input.mp4

3.4 输出格式：让数据可以被程序消费

命令行看信息没问题，但如果你要写脚本自动化处理，就需要结构化输出。ffprobe 支持多种格式。

JSON 格式（最常用）：

ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

输出是标准的 JSON，可以直接被 Python、JavaScript 等语言解析。我在做自动化转码平台时，就是用这个接口获取源文件信息，然后动态生成转码参数。

CSV 格式（适合表格处理）：

ffprobe -v quiet -print_format csv -show_streams input.mp4

输出是逗号分隔的值，可以直接导入 Excel 或 Google Sheets。适合批量分析多个文件时做对比。

Flat 格式（简洁键值对）：

ffprobe -v quiet -print_format flat -show_streams input.mp4

输出类似 streams.stream.0.codec_name="h264"，适合 shell 脚本用 grep 和 awk 处理。

3.5 实战场景：快速诊断文件问题

光讲参数没意思，咱们来几个真实场景。你想想看，遇到下面这些问题，你怎么用 ffprobe 快速定位？

场景一：视频播放卡顿，怀疑是码率太高

ffprobe -v quiet -show_format input.mp4 | grep bit_rate

或者用 JSON 格式更清晰：

ffprobe -v quiet -print_format json -show_format input.mp4 | jq '.format.bit_rate'

如果比特率是 50Mbps，而你的设备只支持 20Mbps，那卡顿就正常了。需要转码降码率。

场景二：视频没有声音，检查音频流是否存在

ffprobe -v quiet -show_streams -select_streams a input.mp4

如果输出为空，说明文件里根本没有音频流。我曾经接到一个紧急工单，说“转码后视频没声音”，结果一查，源文件本身就是无声的。嗯，白忙活一场。

场景三：检查视频是否包含关键帧（用于精准切割）

ffprobe -v quiet -select_streams v:0 -show_frames -show_entries frame=pict_type input.mp4 | grep pict_type | head -20

输出会显示 I、P、B 帧。如果 I 帧太少，说明关键帧间隔太长，切割时可能不准。这时候就需要用 -g 参数重新编码。

3.6 知识体系：ffprobe 的核心逻辑

说了这么多，咱们用一张图把 ffprobe 的知识体系串起来。你一看就明白。

3.7 进阶技巧：组合参数实现高效探测

单个参数用熟了，就该组合起来用了。我分享几个我日常工作中高频使用的组合。

组合一：一键获取所有关键信息（JSON 格式）

ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

这是我最常用的命令。输出一个完整的 JSON 对象，包含容器信息和所有流信息。写脚本时直接解析，省事。

组合二：只获取视频分辨率、编码和帧率

ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height,codec_name,r_frame_rate input.mp4

-show_entries 可以精确指定要显示的字段，避免输出冗余信息。输出类似：

[STREAM]
width=1920
height=1080
codec_name=h264
r_frame_rate=30000/1001
[/STREAM]

帧率显示为分数 30000/1001，约等于 29.97fps。嗯，标准的 NTSC 帧率。

组合三：批量分析目录下所有视频文件

for f in *.mp4; do
  echo "=== $f ==="
  ffprobe -v quiet -print_format csv -show_entries stream=codec_name,width,height "$f"
done

这个脚本会遍历当前目录下所有 mp4 文件，输出每个文件的编码和分辨率。我曾经用这个脚本一次性检查了 2000 个视频文件，找出其中混入的 H.265 编码文件，然后统一转码。

3.8 避坑总结：ffprobe 使用中的常见问题

最后，我把自己踩过的坑总结一下，你遇到了直接对照排查。

• 输出太长卡死终端：用 -show_frames 时一定要加 -read_intervals 限制范围，或者用 -v quiet 减少日志输出。
• JSON 解析失败：确保用了 -v quiet，否则 ffprobe 的日志信息会混入 JSON 输出，导致解析报错。
• 流索引搞错：有些文件有多个视频流（比如主视频 + 画中画），用 -select_streams v:0 只选第一个，别想当然认为只有一个视频流。
• 元数据不准确：ffprobe 读取的是文件头部的元数据，有些封装格式的元数据可能被篡改或丢失。如果发现信息异常，可以用 -show_packets 做更底层的分析。

好了，ffprobe 的核心用法就这些。记住一句话：先探查，再处理。这是 FFmpeg 工作流的第一道工序，也是你避免翻车的最有效手段。