编码与格式 / 系统课时

命令参数的基本结构

命令参数的基本结构

本课解决 FFmpeg 参数“写了却没生效”的常见问题。你将学会按全局参数、输入参数和输出参数组织命令,并通过一个可运行示例验证参数作用域和先后顺序。

学习目标

  • 读懂 FFmpeg 命令的基本骨架
  • 判断参数属于全局、输入还是输出作用域
  • 用 FFprobe 验证输出文件是否符合预期

读取命令骨架

FFmpeg 按从左到右的顺序解析命令。最常见的结构可以概括为下面的表达式,它用于说明位置关系,不是可直接执行的命令。

text
ffmpeg [全局参数] [输入参数] -i 输入地址 [输出参数] 输出地址

全局参数控制整个进程,例如 -hide_banner、-loglevel 和 -y。输入参数只作用于紧随其后的输入,必须放在对应的 -i 前。输出参数只作用于紧随其后的输出文件,通常放在输出文件名之前。

FFmpeg 参数作用域结构图

参数位置为何重要

FFmpeg 将非全局参数绑定到“下一个输入”或“下一个输出”。例如,-f lavfi 用来声明下一个输入采用虚拟设备格式,因此必须写在 -i 前;-c:v libx264 用来指定下一个输出的视频编码器,因此要写在输出文件名前。

带流选择器的参数可以进一步限定目标流。-c:v 作用于视频流,-c:a 作用于音频流,-c:v:0 则只作用于第一个视频流。存在多个输出时,不要假设前一个输出的编码参数会自动延续到后一个输出。

完整可运行示例

下面的命令使用 FFmpeg 内置测试源生成 3 秒视频,不依赖外部素材。参数已经按全局、输入和输出三个区域排列。

bash
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'

预期输出:

text
created: output.mp4

其中,-f lavfi 是输入参数;-t 3、-c:v libx264、-pix_fmt yuv420p 和 -an 都是输出参数。-an 表示输出中不包含音频流,-y 表示目标文件已存在时直接覆盖。

使用 FFprobe 检查第一个视频流:

bash
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,width,height -of default=noprint_wrappers=1 output.mp4

预期输出:

text
codec_name=h264
width=640
height=360

常见顺序错误

把输入格式写到 -i 后面,FFmpeg 会先按默认方式解释输入地址,导致格式声明无法作用于该输入。把编码参数写到某个输出文件之后,则它会作用于后续输出,或因没有后续输出而失去意义。

排查时先把命令按“全局参数、每个输入组、每个输出组”重新换行,再逐项确认参数距离哪个 -i 或输出文件最近。复杂命令中,这种分组比单纯记忆参数名称更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

命令参数的基本结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通