FFmpeg信息查询命令全解析：从版本、编码器到ffprobe的排查实战

做音视频开发这几年我养成了一个习惯拿到一台新机器或者一个新的部署环境第一件事不是急着跑转码脚本而是先敲几条ffmpeg基本信息查询命令把手里这套工具的底细摸清楚。这个习惯帮我省下了不少排查问题的时间——很多时候你以为ffmpeg不支持某个编码器其实只是没装对版本你以为某个格式转不了其实只是没选对封装器。ffmpeg的查询命令看着不起眼但它们是整个音视频排查链路的第一环也是最可靠的能力白皮书。这篇文章想做的事情很简单就是系统过一遍ffmpeg家族里跟信息查询相关的命令和参数。从ffmpeg -version看版本和编译配置到ffmpeg -formats、-codecs确认能力边界再到ffprobe探测具体媒体文件的流信息和元数据最后结合我实际工作中踩过的坑聊几种常用的查询组合。不管你是刚开始接触ffmpeg的命令行用户还是已经在做音视频开发但没系统整理过查询命令的人这篇应该都能给你点参考。1. 版本号与编译参数先搞清楚手里的工具是什么版本1.1 -version输出逐行拆解先来最基础的一条命令ffmpeg -version输出大概是这样的ffmpeg version 4.4.2-0ubuntu0.22.04.1 Copyright (c) 2000-2021 the FFmpeg developers built with gcc 11 (Ubuntu 11.4.0-1ubuntu1~22.04) configuration: --prefix/usr --extra-version0ubuntu0.22.04.1 --toolchainhardened --cccc libavutil 56. 70.100 / 56. 70.100 libavcodec 58.134.100 / 58.134.100 libavformat 58. 76.100 / 58. 76.100 libavdevice 58. 13.100 / 58. 13.100 libavfilter 7.110.100 / 7.110.100 libswscale 5. 9.100 / 5. 9.100 libswresample 3. 9.100 / 3. 9.100 libpostproc 55. 9.100 / 55. 9.100第一行是主版本号。4.4.2是FFmpeg自身的版本后面跟的-0ubuntu0.22.04.1是Ubuntu发行版加的标识说明这是通过apt装出来的版本不是FFmpeg官方构建。很多人在网上搜方案时会发现命令对不上有时候就是版本导致的差异所以第一步看版本号非常必要。第二行built with告诉你它是用哪个编译器编出来的对排查运行环境缺什么动态库这类问题有点参考价值。第三行configuration是整个输出的精华所在它记录了编译时启用了哪些功能、打进了哪些第三方库比如是否编了libx264、libfdk-aac、libvpx这些外部库全都体现在这一行里。最后那几行libavutil、libavcodec、libavformat等是FFmpeg各子库的版本号格式是当前版本/编译时版本如果两个数字对不上说明你正在运行的二进制和它编译链接的库版本不一致这种情况通常会导致运行时出现莫名其妙的符号错误需要特别警惕。提示在绝大多数环境里FFmpeg默认把所有日志都输出到stderr而不是stdout。如果你在脚本里用了ffmpeg -version | grep这类管道却发现抓不到内容先确认一下是不是没加21。常见的grep configuration写法建议写成ffmpeg -version 21 | grep configuration。1.2 configuration与-buildconf编译选项决定能力上限ffmpeg -version里的configuration字段往往只有一行如果不够直观可以看看-buildconf这个选项。不少版本支持直接输出完整编译配置ffmpeg -buildconf它本质上就是把你configure阶段的参数原样打印出来。如果你的版本不支持-buildconf退回看-version里的configuration字段就行信息是同一个来源。为什么编译配置这么重要因为FFmpeg的很多能力是编译期决定的运行时无法事后补上。比如--enable-libx264才能用libx264编码器否则用-c:v libx264会报Unknown encoder--enable-libfdk-aac才能在音频编码时选fdk_aac这个库因为授权原因很多发行版默认不开所以用apt装的ffmpeg往往没有--enable-nvenc、--enable-vaapi这些决定了硬件编码器是否可用查-hwaccels列出的硬件方案本质上也是编译期选项的映射。我经常在群里的讨论中看到ffmpeg不能转H.265这类结论其实很多不是ffmpeg不行而是你用的这个构建里没编进相关功能。先跑一次-buildconf看一眼比反复试命令强得多。1.3 怎么判断当前环境是官方构建还是系统包判断一个ffmpeg是官方构建还是包管理器装的有几个线索。最简单的是看版本号后缀官方静态构建版本通常是ffmpeg version 6.1.1-essentials_build或者类似的标识而apt、brew、yum装出来的通常会带发行版名称或版本标识比如-0ubuntu0.22.04.1。其次是看编译路径官方构建的built with一般指向某个固定工具链或容器路径系统包则往往包含/usr/bin/等标准路径。再一个就是看configuration里--prefix的值系统包通常--prefix/usr而如果你是自己源码编译的--prefix一般会指向自定义目录比如/usr/local/ffmpeg。搞清楚这个有什么实际意义因为它直接影响你后面查滤镜、查编码器的结果。系统仓库里的ffmpeg为了保证Linux发行版的GPL/LGPL合规通常会裁剪掉一部分非自由库而官方静态构建在功能上往往更全。如果你跑完ffmpeg -filters发现连loudnorm这种常用滤镜都没有大概率是用的构建太精简了这时候验明正身、换个构建是更高效的做法。2. 支持格式与编码器清单ffmpeg到底能吃什么吐什么2.1 -formats输出解读ffmpeg -formats这是查询封装格式的命令输出很长头部是这样的File formats: D. Demuxing supported .E Muxing supported -- D 3dostr 3DO STR E 3g2 3GP2 (3GPP file format) DE 3gp 3GP (3GPP file format)第一列的两个字母D代表Demuxing也就是解封装E代表Muxing也就是封装。DE两个都有说明这个格式既能读也能写。有些格式只有D没有E说明ffmpeg能解析它但写不了有些只有E说明只能输出这个格式。这里要帮新手建立一个关键概念容器格式和编码格式是两回事。MP4、MKV、FLV这类是容器格式相当于行李箱H.264、AAC、MP3这些是编码格式相当于行李箱里的衣物。一个MP4文件里可以装H.264也可以装MPEG-4 Visual一个MKV里可以同时装H.264、FLAC、ASS字幕。所以查询容器格式支持情况时不要跟编码器支持混为一谈。你ffmpeg -formats看到mp4的E是支持的不代表所有编码流都能封装进MP4比如Matroska里常见的FLAC音轨如果硬往MP4里塞ffmpeg通常会直接报错。2.2 -codecs、-encoders、-decoders三兄弟的区别ffmpeg -codecs ffmpeg -encoders ffmpeg -decoders这三个命令经常有人搞混。-codecs列出的是编解码器全量清单包含每种codec的解码和编码能力标记-encoders只列能用来编码的-decoders只列能用来解码的。对于音视频开发来说最常用的是-encoders因为选编码器时先查这一项就能判断-c:v xxx能不能跑通。-codecs的输出行首有一串字母标记含义大概是V..... Video A..... Audio S..... Subtitle .D.... Decoding supported .E.... Encoding supported ..S... Slice-level multithreading ...X. Codec is experimental比如输出里有一行AV.D.. h264就说明h264支持视频编解码、解码可用、编码可用。如果你看到某行只有.D..而没有.E..说明只能解不能编。另外注意--enable-libx264是否被编译进configuration如果没编进去即使-codecs里能看到原生h264编码器比如mpeg4也不代表你能用libx264。这里分享一个实战技巧。如果你在写转码脚本时拿不准某个编码器名称到底存不存在别直接跑完整命令先这样过滤ffmpeg -encoders 21 | grep -E libx264|h264_nvenc|hevc_nvenc看到输出列出libx264和h264_nvenc这两个名字后再去跑真正的转码命令成功率会高很多。2.3 -filters查询滤镜音视频处理管线的零件库滤镜是ffmpeg最强大的部分之一但前提是你得知道当前构建里有哪些滤镜可用。查询命令ffmpeg -filters输出列表也是极长头部有缩写标记表示滤镜是否支持Timeline、多线程等特性。这里的关键是你需要刻意把查询范围缩小不然屏幕上瞬间滚过几百行什么都看不清。常用的办法就是grepffmpeg -filters 21 | grep loudnorm ffmpeg -filters 21 | grep scale ffmpeg -filters 21 | grep -E fps|setpts比如你要做响度归一化loudnorm这个滤镜现在基本是标配方案但如果你这个ffmpeg没编进去-af loudnorm就会直接报No such filter。先查一下列表就能把这类低级错误在写命令之前排除掉。滤镜方案设计时我习惯把需要的滤镜名先扫一遍相当于确认工具库里有没有对应的零件再开始画处理管线。2.4 硬件加速和像素格式查询ffmpeg -hwaccels这条命令输出列出的硬件加速方法比如cuda、qsv、vaapi、videotoolbox、d3d11va等。它直接反映了当前二进制的硬件能力边界。配合-decoders你还能确认具体的硬解解码器是否存在ffmpeg -decoders 21 | grep -E h264_cuvid|hevc_cuvid|h264_qsv另外一个容易被忽略的查询是像素格式ffmpeg -pix_fmts为什么这个对我很重要因为做硬件编码时经常需要知道输入像素格式是否匹配。比如NVIDIA的NVENC编码器通常接受NV12输入如果你软件端的像素格式是yuv420p就需要在滤镜链里加formatnv12这一步转换。做音频处理时则用ffmpeg -sample_fmts确认采样格式fltp、s16、s32等因为像fdk_aac、AAC编码器对采样格式有明确要求格式不匹配也会报错。这几个查询命令在调试滤镜链时是救命级别的。3. ffprobe 与 ffmpeg -i文件信息的查询双通道3.1 ffmpeg -i最朴素的文件信息概览聊完ffmpeg自身的信息查询再说说对具体媒体文件的信息查询。第一件工具其实是ffmpeg自己的-i参数ffmpeg -i input.mp4注意不要加输出文件ffmpeg就会只打印输入文件的信息然后退出不执行任何转码。它会输出类似这样的内容Input #0, mov,mp4,m4a,3gp,3g2,mj2, from input.mp4: Metadata: major_brand : isom minor_version : 512 compatible_brands: isomiso2avc1mp41 duration : 00:03:46.12 bitrate : 1200 kb/s Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1280x720 [SAR 1:1 DAR 16:9], 1000 kb/s, 30 fps, 30 tbr, 1200k tbn Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 128 kb/s这个输出读起来很直白封装格式是mov/mp4时长、码率、每条流的编码、分辨率、帧率、采样率、声道数都给你列出来了。但有一个反直觉的点——这些信息是走stderr输出的单纯用ffmpeg -i input.mp4在终端里看没问题一旦你想在shell脚本里捕获它没加21就什么都抓不到。这是非常经典的一个新手坑。另外要明确一点ffmpeg -i只是粗略扫一眼的场景它不做结构化输出解析起来麻烦。更专业的工具是ffprobe这个我们展开讲。3.2 ffprobe的基本用法与show_format/show_streamsffprobe是FFmpeg家族里专门干探测活的工具它不转码、不做处理只读取并分析媒体文件的信息。最基本的一条ffprobe -show_format -show_streams input.mp4两个参数的职责分得清楚-show_format展示容器层信息包括封装格式名称、总时长、总码率、容器metadata。-show_streams展示每条流的详细信息包括编码、分辨率、帧率、采样率、声道、profile、像素格式、编码配置、B帧数等。先解释很多新人困惑的地方为什么时长有两个-show_format里的duration是容器级别的时长记录在文件头里可能约等于流级别的时长总和而每个流的duration是该流自己的持续时间。如果你拿到的文件是录播中突然中断产生的有时候容器时长会比实际流时长长很多这时候以-show_streams里最完整的那条流时长为准更可靠。知道这个区别你才能判断ffprobe输出的数字到底信哪一个。再提一个实用小参数-select_streams。比如只查视频流ffprobe -v error -select_streams v:0 -show_entries streamcodec_name,width,height,avg_frame_rate -of csvp0 input.mp4v:0表示第一个视频流-show_entries声明只取哪些字段-of csvp0把输出格式改成csv且不带key名结果干净利落适合在脚本里直接赋值给变量。3.3 JSON输出与jq配合ffprobe输出默认是INI风格的键值对。一旦面对几十条流、上百个字段还是转成JSON更清晰ffprobe -v error -print_format json -show_format -show_streams input.mp4拿到JSON之后在命令行里配合jq做过滤是标准操作。比如我只想看视频流的编码、分辨率和帧率ffprobe -v error -print_format json -show_streams input.mp4 | jq .streams[] | select(.codec_typevideo) | {codec_name, width, height, avg_frame_rate}输出就是一个很干净的JSON片段。再比如我想批量拿到一个目录里所有MP4的时长写个循环配合jq就行for f in *.mp4; do printf %s\t $f ffprobe -v error -print_format json -show_format $f | jq -r .format.duration done这个组合在验收媒资库、做自动化检测时是真正的主力工具。我不建议在需要程序化获取信息时去解析ffmpeg -i那种人类可读输出正则写起来又脆又笨ffprobe输出JSON的结构化程度是碾压级的。3.4 对单个参数做极简查询如果你想查一个特定参数又不想输出一大坨JSON可以这样ffprobe -v error -show_entries formatduration -of csvp0 input.mp4 ffprobe -v error -show_entries streamr_frame_rate -select_streams v:0 -of csvp0 input.mp4-of csvp0的意思是不打印字段名只打印值配合-show_entries指定字段整体就是一个极简查询器。这种写法最大的好处是输出稳定且只包含你关心的信息在shell脚本里可以直接放到变量里用。比如要判断一个视频是否超过两分钟dur$(ffprobe -v error -show_entries formatduration -of csvp0 input.mp4 | cut -d. -f1) if [ $dur -gt 120 ]; then echo long video fi4. 查询结果的实战应用用信息决定处理方案4.1 用codec信息决策是否转码FFmpeg的信息查询不是为了查而查最终还是要落到处理方案上。最常见的决策场景就是判断这个文件能不能直接复用到目标容器里。Linux系统包里很有名的一个组合是这样的输入文件是MKV容器里面装了一条h264视频流和一条flac音频流而你希望输出成MP4。如果不查信息直接跑ffmpeg -i in.mkv -c copy out.mp4经常会遇到flac in mp4不支持之类的错误。因为MP4容器对音频编码的支持范围里没有flac至少在很多构建的默认muxer配置下不行。这时候先跑一下ffprobe发现音轨是flac就知道要么转音频编码要么保留MKV容器。同样是-c copy如果目标平台需要统一成MP4而源文件里音轨恰好是AAC那就可以放心娱乐复制。这种先查询再决策的工作流本质上就是音视频处理里最重要的基本功。4.2 硬解码可用性与hwaccel选择在服务器上做转码时GPU硬解能省下大量CPU资源。但你拿到手的ffmpeg未必开了硬件支持。我用ffmpeg -hwaccels确认环境支持cuda之后还得再确认解码器是否可用ffmpeg -decoders 21 | grep -E h264_cuvid|hevc_cuvid如果硬件方案和解码器都在那么跑ffmpeg -hwaccel cuda -c:v h264_cuvid -i input.mp4 -c:v h264_nvenc output.mp4就有把握不会在解码环节报Unknown decoder或Dynamic loading错误。顺带提醒一句硬解码的输入像素格式往往受限如果在实际执行时遇到hardware accelerator failed to decode之类的错误别急着怪字面上的解码器先用ffprobe -show_streams看一下源文件的pix_fmt和profileH.264 High 10bit这类Profile硬解出来可能有问题并且NVENC对输入格式也有要求。查询命令查到的信息是有没有至于能不能跑得顺还得结合文件本身的profile、level来综合判断。4.3 滤镜链设计前的可行性检查处理响应式音频转码、响度归一化这类任务时我通常会先把滤镜是否存在确认了再设计chain。比如要用loudnorm做响度归一化就ffmpeg -filters 21 | grep loudnorm看到结果可用再写-af loudnormI-16:TP-1.5:LRA11这类参数。单条滤镜都查过之后再去考虑滤镜间的数据流关系。比如你想给视频加水印需要overlay滤镜同时想缩放又需要scale滤镜多个滤镜要连起来。设计之前跑一遍-filters看这些滤镜在不在是很低成本的防护。还有一个细节像素格式转换在滤镜链里往往以format滤镜的形式出现比如formatnv12。负责编码的滤镜或者编码器对像素格式有硬性要求时你要能在滤镜链里加格式转换。用ffmpeg -pix_fmts确认目标格式存在避免滤镜链写一半遇到Conversion not allowed之类的问题。4.4 查询时遇到invalid argument怎么排查热搜词里出现ffmpeg invalid argument我在实际交流中也确实经常被问到。拿信息查询命令举例最常见的情况是ffprobe或ffmpeg -i在解析文件时直接报input.mp4: Invalid argument这个报错看起来像你参数写错了但很多情况下其实是文件本身的问题。我的排查链路是这样的第一步先用最朴素的方式看文件能不能被识别file input.mp4如果file命令都识别不了正确的类型说明文件头可能已经坏了。第二步用ffprobe -v trace -show_streams input.mp4看解析到哪一步卡住。-v trace会输出非常冗长的内部日志正常情况下用不上但排查这类问题时能直接看到是demuxer打开失败、流解析报错还是metadata读取异常。第三步检查文件名本身比如中文、空格、特殊字符的问题Windows下尤其常见。有时候你看着命令没毛病实际上shell把文件名拆成了两个参数ffmpeg自然就Invalid argument了。把文件路径用引号包好最稳妥。注意-v trace的日志量非常大纯定位问题的话建议把输出重定向到文件里看ffprobe -v trace -show_streams input.mp4 2trace.log。5. 信息查询的常见坑几条我踩过的硬教训5.1 一套完整的环境摸底命令组合我现在每部署一个ffmpeg环境都会先跑一遍这组命令ffmpeg -version 21 | head -5 ffmpeg -buildconf 2/dev/null | head -20 || true ffmpeg -formats 21 | wc -l ffmpeg -codecs 21 | wc -l ffmpeg -decoders 21 | grep -c hevc ffmpeg -hwaccels 21 ffprobe -version这组命令看下来我能快速知道几件事主版本和小版本是什么、编译配置里有没有关键的第三方库、封装格式和codec总量是多少、HEVC解码器在不在、硬件加速路径有哪些。跑一次不会消耗多少时间却能在后续转码排错时节省大把时间。你总不想排查了一个小时最后发现是ffmpeg构建本身缺东西。5.2 明确一件事查询命令是无损操作这条写给所有刚开始接触命令行的朋友ffmpeg -i、ffmpeg -formats、ffmpeg -codecs、ffmpeg -filters、ffmpeg -hwaccels以及ffprobe的绝大多数查询参数都只会读取信息、打印输出不会修改你正在检查的文件。你可以放心对上线环境里的素材跑这些命令不存在查一下把文件查坏了的担忧。真正需要注意的反而是一条介于查询与处理之间的命令ffmpeg -v error -i input.mp4 -f null -这个命令会把输入文件完整解码一遍用null这个输出设备丢弃所有解码后的数据从而检验文件从容器到解码链路是否完全正常。它在质检场景下非常有用但它会消耗CPU资源、跑完整条视频流耗时会比较长跟日常的信息查询不是一个量级。我提醒团队里的新人时经常强调-f null -是解码压力测试而不是信息查询拿大文件跑之前先掂量一下机器负载。5.3 几条骨感的教训教训一不要迷信网上教程里的输出截图。FFmpeg从4.x到5.x、6.x很多命令行参数的输出格式变了滤镜行为也可能有变化。你手上这个版本的实际情况以ffmpeg -version、ffmpeg -filters、ffprobe -h这些实时查询结果为准。教训二包管理器装的不一定够用。Ubuntu apt的ffmpeg、CentOS yum的ffmpeg配置选项有时候会保守很多。查-filters时发现常用滤镜缺失别尝试硬改命令直接换成官方静态构建或者自己编一个能力完整的版本更省事。教训三Windows环境的路径问题。Windows下用命令时如果路径带空格一定要用引号包住整个路径另外ffmpeg -i C:\my files\in.mp4这种写法在反斜杠路径里还得小心转义。很多Invalid argument都源于路径被shell拆碎了。教训四容器格式和编码格式必须分开理解。看见.mp4就默认里面一定是H.264AAC这是音视频新人最容易犯的判断失误。MKV里装H.264FLAC、MP4里装HEVC、TS流里装AAC都常见。凡是需要基于文件内容做决策的场景先跑一条ffprobe看codec_type、codec_name再下结论。教训五-version里的主版本号在排查问题时不一定是最有用的数字。真正能帮你定位某个behavior差异的往往是你正在使用的libavcodec或libavformat子库版本。比如你从网上搜到一篇文章里面讲的是libavcodec 59时代的行为跟你这个libavcodec 58环境有差别你就知道不能全盘照搬了。我的习惯是每部署一个新环境就把ffmpeg -version里那几行库版本号和configuration存进一个baseline文本文件里。后面哪天突然有命令跑不动了先拿当前输出跟baseline对比一下如果库版本变了大概率是二进制被换掉了如果configuration变了那八成是编译选项跟不上了。这一套做下来查询命令的价值就从一个临时工变成了环境审计的底稿。希望这篇ffmpeg基本信息查询命令的整理能帮你下次拿到新环境时少走点弯路。