编码与格式 / 系统课时
命令参数的基本结构
命令参数的基本结构
本课解决 FFmpeg 参数“写了却没生效”的常见问题。你将学会按全局参数、输入参数和输出参数组织命令,并通过一个可运行示例验证参数作用域和先后顺序。
学习目标
- 读懂 FFmpeg 命令的基本骨架
- 判断参数属于全局、输入还是输出作用域
- 用 FFprobe 验证输出文件是否符合预期
读取命令骨架
FFmpeg 按从左到右的顺序解析命令。最常见的结构可以概括为下面的表达式,它用于说明位置关系,不是可直接执行的命令。
ffmpeg [全局参数] [输入参数] -i 输入地址 [输出参数] 输出地址全局参数控制整个进程,例如 -hide_banner、-loglevel 和 -y。输入参数只作用于紧随其后的输入,必须放在对应的 -i 前。输出参数只作用于紧随其后的输出文件,通常放在输出文件名之前。

参数位置为何重要
FFmpeg 将非全局参数绑定到“下一个输入”或“下一个输出”。例如,-f lavfi 用来声明下一个输入采用虚拟设备格式,因此必须写在 -i 前;-c:v libx264 用来指定下一个输出的视频编码器,因此要写在输出文件名前。
带流选择器的参数可以进一步限定目标流。-c:v 作用于视频流,-c:a 作用于音频流,-c:v:0 则只作用于第一个视频流。存在多个输出时,不要假设前一个输出的编码参数会自动延续到后一个输出。
完整可运行示例
下面的命令使用 FFmpeg 内置测试源生成 3 秒视频,不依赖外部素材。参数已经按全局、输入和输出三个区域排列。
ffmpeg -hide_banner -loglevel error -y -f lavfi -i "testsrc2=size=640x360:rate=25" -t 3 -c:v libx264 -pix_fmt yuv420p -an output.mp4 && printf 'created: output.mp4\n'预期输出:
created: output.mp4其中,-f lavfi 是输入参数;-t 3、-c:v libx264、-pix_fmt yuv420p 和 -an 都是输出参数。-an 表示输出中不包含音频流,-y 表示目标文件已存在时直接覆盖。
使用 FFprobe 检查第一个视频流:
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height -of default=noprint_wrappers=1 output.mp4预期输出:
codec_name=h264
width=640
height=360常见顺序错误
把输入格式写到 -i 后面,FFmpeg 会先按默认方式解释输入地址,导致格式声明无法作用于该输入。把编码参数写到某个输出文件之后,则它会作用于后续输出,或因没有后续输出而失去意义。
排查时先把命令按“全局参数、每个输入组、每个输出组”重新换行,再逐项确认参数距离哪个 -i 或输出文件最近。复杂命令中,这种分组比单纯记忆参数名称更可靠。