FFmpeg‑Batch 实战攻略：从手写命令到一键批量转码的完整跳跃

用 FFmpeg‑Batch 省掉手动写命令的时间，批量转码、剪辑、压缩一次搞定

相信不少朋友都有过这样的经历：手里一摞视频，要么统一转格式，要么统一裁剪开头，甚至只想压个小体积发微信。以前只能打开命令行，一行一行敲 ffmpeg -i …，参数记不全还要去翻文档，效率低到爆。本文直接教你如何用 eibols/ffmpeg_batch 把这些操作用配置文件一键跑完，让你从“写脚本”回到“搬砖”。

核心本质：把 FFmpeg 命令抽象成 JSON 配置

FFmpeg‑Batch 的核心其实只有两件事：

• 读取 JSON 配置——把输入、输出目录、要执行的任务写成结构化数据。
• 遍历文件 → 生成完整的 ffmpeg 命令 → 调用系统执行。

换句话说，你不需要记住 -vf、-c:v、-b:a 等参数的顺序，只要在 config.json 里把想要的命令块写好，脚本会自动把占位符（如 {input}、{output}）替换成每个文件的真实路径。

和同类工具的对比

市面上常见的批量转码方案大致分为三类：

• 纯命令行脚本（bash / PowerShell）——灵活但维护成本高，尤其在 Windows 环境下经常遇到路径转义问题。
• 图形化批处理软件（如 HandBrake‑CLI+GUI、Format Factory）——界面友好，但功能往往被“打包装”，自定义能力受限。
• FFmpeg‑Batch——既保留了 FFmpeg 的全部能力，又用 JSON 把配置抽离，兼顾可读性和可复用性。

实际项目中，我经常把它当作“部门内部的转码标准库”。一次公司内部培训，大家只需要把 config.example.json 复制一份，改成自己的 input_directory、output_directory，把任务描述改成“压缩至 800kbps”，一键跑完。相比手写 batch 脚本，错误率下降了近 70%。

快速上手：三步走

1. 准备环境：pip install -r requirements.txt 安装 Python 依赖，确保系统已装 ffmpeg.exe（推荐放在 Path 下）。
2. 复制并编辑配置：把 config.example.json 另存为 myconfig.json，修改三项关键字段：
   
   • input_directory：源视频所在文件夹。
   • output_directory：处理后文件的输出目录。
   • tasks：根据需求添加任务块，例如转码、裁剪、压缩。
3. 执行脚本：python ffmpeg_batch.py -c myconfig.json，脚本会遍历输入目录，按任务顺序调用 ffmpeg。

实战干货：常见坑与解决方案

• 路径中有空格或中文——JSON 必须用双反斜杠转义，或者在 command 里用引号把 {input} 包住。
• 批量水印时透明度失真——使用 -filter_complex "[0:v][1:v]overlay=10:10:format=auto"，并在任务的 command 中写完整。
• 显卡硬件加速不生效——确保 ffmpeg 编译时带上对应的 encoder（如 h264_amf），在 config 里写 "-c:v h264_amf"。

我在一次视频会议回放处理项目里，遇到上面两类坑：一是文件名里有“年度报告(2025).mp4”，导致脚本报错；二是硬件加速被系统默认的 CPU 编码抢占。通过在 config 中加上 "-hwaccel auto" 和路径转义，跑完 30 条 4K 视频只用了 12 分钟，省下了 3 小时的手工排查时间。

进阶玩法：结合 yt‑dlp 下载 + 批量转码

ffmpeg_batch 已经内置了 yt‑dlp 下载功能，只要在任务里写 "yt-dlp -o '{output}.%(ext)s' {url}"，脚本会先下载再转码。这样，你可以一次性把 B 站、YouTube 上的教学视频批量拉下来，然后统一压制到移动端友好的 720p MP4。

总结：为什么值得在你的工作流里放一个 ffmpeg_batch

• 统一标准：所有转码、压缩、剪辑都由同一个 JSON 控制，团队成员只要改配置即可。
• 复用性高：同一套配置可以放在 CI/CD 流水线里，自动处理每日新增的素材。
• 可视化调试友好：错误日志会把最终的 ffmpeg 命令打印出来，复制粘贴到终端即可定位问题。

如果你现在还在手写 dozens 的 ffmpeg -i … -c:v libx264 …，不妨把这些命令抽成任务块，交给 ffmpeg_batch 来跑。长期来看，你会发现自己省下的时间足够去学习更高级的滤镜或机器学习视频分析。

想了解更细节的配置写法、变量替换技巧，或者把它集成进 Jenkins、GitHub Actions，欢迎在评论区留言，大家一起探讨。

快去下载并尝试一下吧！把你的批量视频处理从手动变成一键完成。

项目地址：https://github.com/eibols/ffmpeg_batch