编码与格式 / 系统课时
批量处理媒体文件
批量处理媒体文件
本课实现一个可直接运行的 Bash 批处理脚本:递归扫描媒体文件,保持原目录结构生成 MP4,跳过已有结果,并记录每个文件的成功或失败状态。完成后,你可以安全地重复执行任务并快速定位异常文件。
学习目标
- 使用空字符分隔方式安全遍历带空格的文件名
- 为每个输入文件生成稳定且不冲突的输出路径
- 记录处理状态,并让单个失败不阻断整批任务
明确批处理流程
批处理不只是给 FFmpeg 套一层循环,还要同时处理文件发现、扩展名过滤、目录映射、重复执行和错误收集。脚本应让每个输入文件独立完成一次“判断、转换、记录”,最后再汇总结果。

使用 find -print0 输出空字符分隔的路径,再用 read -d '' 读取,可以避免空格和换行导致文件名被错误拆分。
编写批处理脚本
将下面内容保存为 batch-media.sh。脚本接收输入目录、输出目录和日志文件三个参数;未传入时使用默认值。
#!/usr/bin/env bash
set -uo pipefail
input_dir="${1:-./input}"
output_dir="${2:-./output}"
log_file="${3:-./batch.log}"
mkdir -p "$output_dir"
: > "$log_file"
success=0
failed=0
skipped=0
while IFS= read -r -d '' src; do
relative="${src#"$input_dir"/}"
stem="${relative%.*}"
dst="$output_dir/$stem.mp4"
mkdir -p "$(dirname "$dst")"
if [[ -f "$dst" ]]; then
printf 'SKIP %s -> %s\n' "$src" "$dst" | tee -a "$log_file"
((skipped++))
continue
fi
# 单个文件失败时继续处理后续文件,并清理可能生成的残缺输出。
if ffmpeg -hide_banner -loglevel error -y \
-i "$src" \
-c:v libx264 -preset medium -crf 23 \
-c:a aac -b:a 128k \
-movflags +faststart \
"$dst"; then
printf 'OK %s -> %s\n' "$src" "$dst" | tee -a "$log_file"
((success++))
else
rm -f "$dst"
printf 'FAIL %s\n' "$src" | tee -a "$log_file"
((failed++))
fi
done < <(
find "$input_dir" -type f \
\( -iname '*.mp4' -o -iname '*.mov' -o -iname '*.mkv' \) \
-print0 | sort -z
)
printf 'SUMMARY success=%d failed=%d skipped=%d\n' \
"$success" "$failed" "$skipped" | tee -a "$log_file"
((failed == 0))最后一行让脚本在存在失败文件时返回非零状态,方便 CI、定时任务或上层程序判断整批任务是否完全成功。
准备样例并执行
下面的命令生成两个一秒钟的测试文件,再运行批处理脚本。生成测试文件时使用 -loglevel error,成功时不会打印 FFmpeg 进度日志。
chmod +x batch-media.sh
rm -rf demo-input demo-output batch.log
mkdir -p demo-input/sub
ffmpeg -hide_banner -loglevel error -y \
-f lavfi -i "testsrc=size=320x240:rate=25" \
-f lavfi -i "sine=frequency=1000" \
-t 1 -c:v libx264 -pix_fmt yuv420p -c:a aac \
"demo-input/one.mp4"
ffmpeg -hide_banner -loglevel error -y \
-f lavfi -i "testsrc2=size=320x240:rate=25" \
-f lavfi -i "sine=frequency=600" \
-t 1 -c:v libx264 -pix_fmt yuv420p -c:a aac \
"demo-input/sub/two.mov"
./batch-media.sh demo-input demo-output batch.log预期输出如下:
OK demo-input/one.mp4 -> demo-output/one.mp4
OK demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=2 failed=0 skipped=0再次执行同一命令时,两个输出文件已经存在,因此预期结果变为:
SKIP demo-input/one.mp4 -> demo-output/one.mp4
SKIP demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=0 failed=0 skipped=2验证输出与日志
使用 find 检查目录映射,再读取日志确认最终一次运行的状态。
find demo-output -type f -print | sort
cat batch.log第二次执行批处理后,预期输出为:
demo-output/one.mp4
demo-output/sub/two.mp4
SKIP demo-input/one.mp4 -> demo-output/one.mp4
SKIP demo-input/sub/two.mov -> demo-output/sub/two.mp4
SUMMARY success=0 failed=0 skipped=2脚本每次启动都会用 : > "$log_file" 清空旧日志。如果需要长期审计,可改为追加模式,并在每批开始时写入任务 ID 与时间;动态时间应记录为实际值,而不是写死在脚本中。
常见失败与修复
出现 No such file or directory 时,先确认输入目录存在,并检查调用脚本时的工作目录。自动化任务通常不应依赖相对路径,生产环境建议传入绝对路径。
出现 Unknown encoder 'libx264' 时,说明当前 FFmpeg 构建未包含该编码器。可用 ffmpeg -encoders 检查能力,再按平台安装包含 libx264 的构建,或把脚本中的编码器替换为环境实际支持的实现。
出现部分文件失败时,查看日志中的 FAIL 路径,并单独运行对应 FFmpeg 命令获取完整错误信息。批处理阶段使用 -loglevel error 控制噪声,单文件排查时可改为 -loglevel info。