FFmpeg CLI 参考手册

版本：8.0.1 | 安装路径：/opt/homebrew/bin/ffmpeg

官方地址：https://ffmpeg.org/ | 安装命令：brew install ffmpeg

编译器：Apple clang 17.0.0 | 架构：ARM64 (Apple Silicon)

FFmpeg 是开源的跨平台音视频处理工具集，支持几乎所有音视频格式的录制、转换、流化处理。核心由 ffmpeg（转码）、ffprobe（分析）、ffplay（播放）三个命令组成。

安装信息

编译配置

--prefix=/opt/homebrew/Cellar/ffmpeg/8.0.1_4

--enable-shared
--enable-pthreads
--enable-version3
--enable-ffplay
--enable-gpl
--enable-libsvtav1        # AV1 编码 (SVT-AV1)
--enable-libopus          # Opus 音频编解码
--enable-libx264          # H.264 编码
--enable-libmp3lame       # MP3 编码
--enable-libdav1d         # AV1 解码 (dav1d)
--enable-libvpx           # VP8/VP9 编解码
--enable-libx265          # H.265/HEVC 编码
--enable-openssl          # HTTPS/加密协议
--enable-videotoolbox     # macOS 硬件加速
--enable-audiotoolbox     # macOS 音频硬件
--enable-neon             # ARM NEON 指令集

库版本

基础语法

ffmpeg [全局选项] {[输入文件选项] -i 输入文件}... {[输出文件选项] 输出文件}...

通用模式

ffmpeg -i input.mp4 output.mkv                        # 基础转换

ffmpeg -i input1.mp4 -i input2.mp3 output.mp4         # 多输入
ffmpeg -y -i input.mp4 output.mp4                     # 覆盖输出
ffmpeg -n -i input.mp4 output.mp4                     # 不覆盖已存在文件

全局选项

帮助与信息

输入/输出选项

输入与输出通用选项

仅输入选项

仅输出选项

视频选项

音频选项

字幕选项

流控制选项

流选择器语法

流选择器 [:stream_spec] 可以是：

• 流索引号（如 :0 :1）
• v 视频 / a 音频 / s 字幕
• 省略时对所有流生效

-c:v libx264        # 设置视频编码器

-c:a copy           # 音频直接复制
-c:s mov_text       # 字幕编码器

滤镜系统

基本语法

-vf "filter1,filter2,filter3"       # 视频滤镜链

-af "filter1,filter2"                # 音频滤镜链
-filtercomplex "complexgraph"      # 复杂滤镜图

常用视频滤镜

常用音频滤镜

复杂滤镜图

两路输入的叠加

ffmpeg -i background.mp4 -i overlay.png \
  -filter_complex "[0:v][1:v]overlay=W-w-10:H-h-10" output.mp4
多视频拼接

ffmpeg -i part1.mp4 -i part2.mp4 -i part3.mp4 \
  -filter_complex "[0:v][1:v][2:v]concat=n=3:v=1:a=0" output.mp4
画中画

ffmpeg -i main.mp4 -i pip.mp4 \
  -filter_complex "[0:v]setpts=PTS-STARTPTS[main];[1:v]setpts=PTS-STARTPTS[scaled];[scaled]scale=iw/4:ih/4[pip];[main][pip]overlay=W-w-20:H-h-20" output.mp4
双输出（同时录制和预览）

ffmpeg -i input.mp4 \
  -filter_complex "split[v1][v2]" \
  -map "[v1]" -c:v libx264 -preset fast output.mp4 \
  -map "[v2]" -c:v libx264 -preset ultrafast preview.mp4

高级选项

码率控制

编码预设（x264/x265）

编码调优（x264）

时间戳选项

常用编码器

视频编码器

音频编码器

字幕编码器

支持格式

常用容器格式

硬件加速

本机支持：VideoToolbox（Apple Silicon / macOS 原生）

使用 VideoToolbox 硬件解码

-hwaccel videotoolbox -i input.mp4
使用 VideoToolbox 硬件编码 H.264

-c:v h264_videotoolbox -b:v 5M
使用 VideoToolbox 硬件编码 H.265

-c:v hevc_videotoolbox -b:v 10M -q:v 50
完整硬件加速管道

-hwaccel videotoolbox -hwacceloutputformat videotoolboxvld -i input.mp4 -c:v hevcvideotoolbox output.mp4

ffprobe 工具

ffprobe 是 ffmpeg 套件中的媒体分析工具。

查看文件信息

ffprobe input.mp4
JSON 格式输出

ffprobe -v quiet -printformat json -showformat -show_streams input.mp4
查看流信息（紧凑格式）

ffprobe -v error -showentries stream=codecname,codectype,width,height,duration,samplerate,channels -of default=noprint_wrappers=1 input.mp4
查看格式信息

ffprobe -v error -showentries format=duration,size,bitrate -of default=noprint_wrappers=1 input.mp4
获取视频帧数

ffprobe -v error -selectstreams v:0 -countframes -showentries stream=nbread_frames -of csv=p=0 input.mp4
获取视频分辨率

ffprobe -v error -selectstreams v:0 -showentries stream=width,height -of csv=s=x:p=0 input.mp4
获取音频采样率

ffprobe -v error -selectstreams a:0 -showentries stream=sample_rate -of csv=p=0 input.mp4
获取视频帧率

ffprobe -v error -selectstreams v:0 -showentries stream=rframerate -of csv=p=0 input.mp4

常用命令示例

格式转换

MP4 转 MKV

ffmpeg -i input.mp4 -c copy output.mkv
MKV 转 MP4（重新编码）

ffmpeg -i input.mkv -c:v libx264 -c:a aac output.mp4
视频转 GIF

ffmpeg -i input.mp4 -vf "fps=15,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" output.gif
视频转 WebM

ffmpeg -i input.mp4 -c:v libvpx-vp9 -crf 30 -b:v 0 -c:a libopus output.webm
生成 HLS 流

ffmpeg -i input.mp4 -c:v libx264 -c:a aac -f hls -hlstime 10 -hlslist_size 0 output.m3u8

视频处理

压缩视频（CRF 模式）

ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a copy output.mp4
指定码率压缩

ffmpeg -i input.mp4 -c:v libx264 -b:v 2M -c:a copy output.mp4
缩放分辨率

ffmpeg -i input.mp4 -vf "scale=1280:720" -c:a copy output.mp4
等比缩放（宽度 720，高度自动）

ffmpeg -i input.mp4 -vf "scale=720:-2" -c:a copy output.mp4
裁剪视频（从 00:01:30 开始，持续 30 秒）

ffmpeg -i input.mp4 -ss 00:01:30 -t 30 -c copy output.mp4
精确裁剪（重新编码）

ffmpeg -i input.mp4 -ss 00:01:30 -t 30 -c:v libx264 -c:a copy output.mp4
裁剪画面（去除上下黑边）

ffmpeg -i input.mp4 -vf "crop=1920:800:0:140" -c:a copy output.mp4
提取视频中的某一帧

ffmpeg -i input.mp4 -ss 00:01:00 -frames:v 1 frame.png
提取图片序列

ffmpeg -i input.mp4 -vf "fps=24" frames/frame_%04d.png
调整播放速度（2倍速）

ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" output.mp4
调整播放速度（0.5倍速）

ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" output.mp4
旋转视频 90 度

ffmpeg -i input.mp4 -vf "transpose=1" -c:a copy output.mp4
水平镜像翻转

ffmpeg -i input.mp4 -vf "hflip" -c:a copy output.mp4
垂直翻转

ffmpeg -i input.mp4 -vf "vflip" -c:a copy output.mp4
添加水印

ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" -c:a copy output.mp4

音频处理

提取音频

ffmpeg -i input.mp4 -vn -c:a libmp3lame -q:a 2 output.mp3
提取无损音频

ffmpeg -i input.mp4 -vn -c:a flac output.flac
WAV 转 MP3

ffmpeg -i input.wav -c:a libmp3lame -q:a 2 output.mp3
调整音量（增加 10dB）

ffmpeg -i input.mp3 -af "volume=10dB" output.mp3
音频归一化（EBU R128）

ffmpeg -i input.mp3 -af loudnorm output.mp3
音频淡入淡出

ffmpeg -i input.mp3 -af "afade=in:st=0:d=5,afade=out:st=55:d=5" output.mp3
合并多个音频

ffmpeg -i audio1.mp3 -i audio2.mp3 -filter_complex "[0:a][1:a]concat=n=2:v=0:a=1" output.mp3
混音（两路叠加）

ffmpeg -i audio1.mp3 -i audio2.mp3 -filter_complex "[0:a][1:a]amix=inputs=2:duration=longest" output.mp3

字幕处理

烧录 SRT 字幕

ffmpeg -i input.mp4 -vf "subtitles=sub.srt" -c:a copy output.mp4
烧录 ASS 字幕

ffmpeg -i input.mp4 -vf "ass=style.ass" -c:a copy output.mp4
提取字幕

ffmpeg -i input.mkv -map 0:s:0 subs.srt
添加外挂字幕（不烧录）

ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4
字幕格式转换（SRT 转 ASS）

ffmpeg -i input.srt output.ass

多文件操作

拼接视频（相同编码格式）

先创建 filelist.txt：

  file 'part1.mp4'

  file 'part2.mp4'

  file 'part3.mp4'

ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4
拼接视频（不同编码格式）

ffmpeg -i part1.mp4 -i part2.mp4 -filter_complex "[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1" output.mp4
图片序列转视频

ffmpeg -framerate 30 -i frames/frame%04d.png -c:v libx264 -pixfmt yuv420p output.mp4
音频 + 图片生成视频

ffmpeg -loop 1 -i image.jpg -i audio.mp3 -c:v libx264 -tune stillimage -c:a aac -shortest output.mp4
替换视频中的音频

ffmpeg -i video.mp4 -i new_audio.mp3 -c:v copy -map 0:v:0 -map 1:a:0 output.mp4
提取视频（无音频）

ffmpeg -i input.mp4 -an -c:v copy output.mp4

高级编码

H.264 两遍编码（最佳质量/文件大小比）

ffmpeg -i input.mp4 -c:v libx264 -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -pass 2 -c:a libmp3lame -b:a 128k output.mp4
AV1 编码（SVT-AV1）

ffmpeg -i input.mp4 -c:v libsvtav1 -crf 30 -preset 8 -c:a libopus output.mp4
H.265/HEVC 编码

ffmpeg -i input.mp4 -c:v libx265 -crf 28 -preset medium -c:a aac output.mp4
硬件加速编码（VideoToolbox H.264）

ffmpeg -i input.mp4 -c:v h264_videotoolbox -b:v 5M -c:a aac output.mp4
苹果 ProRes 编码

ffmpeg -i input.mp4 -c:v prores -profile:v 3 -c:a pcm_s24le output.mov
推流到 RTMP 服务器

ffmpeg -re -i input.mp4 -c:v libx264 -preset veryfast -c:a aac -f flv rtmp://server/live/stream_key
从摄像头/屏幕录制（macOS）

ffmpeg -f avfoundation -i "0:0" -c:v libx264 -preset ultrafast output.mp4
屏幕录制

ffmpeg -f avfoundation -i "1:none" -c:v libx264 -preset ultrafast output.mp4

参考资源

• 官方文档：https://ffmpeg.org/documentation.html
• FFmpeg Wiki：https://trac.ffmpeg.org/wiki
• 在线查询编解码器详情：ffmpeg -h encoder=libx264
• 在线查询滤镜详情：ffmpeg -h filter=scale
• 查看完整帮助：ffmpeg -h full