我要评论做后端开发的，多少都会遇到需要程序自动处理音视频文件的场景——给用户上传的视频压缩一下、从录屏里提取音频、或者把一堆图片合成一个视频。ffmpeg 是这类任务的事实标准，但 python 里怎么调它效率最高、最稳定，我踩了不少坑才总结出来。
一、最基础的方式：subprocess.call
最简单的做法就是直接传命令字符串：
import subprocess
# 提取音频
subprocess.call([
'ffmpeg', '-i', 'input.mp4',
'-vn', '-c:a', 'mp3', 'output.mp3'
])call 会阻塞直到命令执行完，返回退出码。好处是简单，坏处是如果命令耗时很长（比如压缩一个 2gb 的视频），程序界面就会卡住。
二、推荐方式：subprocess.run
python 3.5+ 推荐用 run，它返回一个 completedprocess 对象，可以拿到退出码、标准输出和标准错误：
import subprocess
result = subprocess.run(
['ffmpeg', '-i', 'input.mp4', '-vf', 'scale=1280:720', 'output.mp4'],
capture_output=true,
text=true,
timeout=300
)
if result.returncode == 0:
print('转换成功')
else:
print('转换失败:', result.stderr)这里有一个容易忽略的点：timeout 参数。不加的话，ffmpeg 因为某些原因卡住（比如输入文件损坏），你的 python 进程也会一直挂着。设一个合理的超时时间是个好习惯。
三、进阶：实时获取处理进度
ffmpeg 处理大文件时进度信息是输出到 stderr 的，格式大概这样：
frame= 120 fps=30.0 time=00:00:04.00 bitrate=128.0kbits/s speed=1.0x
如果你需要实时显示进度条，可以用 stderr 的管道逐行读取：
import subprocess
import re
def convert_with_progress(input_path, output_path):
cmd = [
'ffmpeg', '-i', input_path,
'-c:v', 'libx264', '-preset', 'medium',
'-progress', 'pipe:1', # 进度信息输出到 stdout
output_path
]
process = subprocess.popen(
cmd, stdout=subprocess.pipe, stderr=subprocess.pipe,
universal_newlines=true, bufsize=1
)
for line in process.stdout:
match = re.search(r'out_time_us=(\d+)', line)
if match:
us = int(match.group(1))
seconds = us / 1_000_000
print(f'已处理: {seconds:.1f} 秒', end='\r')
process.wait()
if process.returncode == 0:
print('\n处理完成')
else:
error = process.stderr.read()
print(f'\n处理失败: {error[:200]}...')
convert_with_progress('large_video.mp4', 'compressed.mp4')这里用 -progress pipe:1 让 ffmpeg 把进度信息输出到 stdout 而不是 stderr，方便 python 读取。bufsize=1 确保逐行读取而不是等缓冲区满。
四、批量处理：结合 pathlib
处理文件夹下的所有文件时，用 pathlib 搭配 ffmpeg 比 os.path 顺手得多：
from pathlib import path
import subprocess
def batch_convert_to_mp3(input_dir: str, output_dir: str, bitrate='192k'):
src = path(input_dir)
dst = path(output_dir)
dst.mkdir(parents=true, exist_ok=true)
files = list(src.glob('*.*'))
for i, file in enumerate(files, 1):
if file.suffix.lower() not in ('.mp4', '.mkv', '.mov', '.avi'):
continue
output = dst / f'{file.stem}.mp3'
print(f'[{i}/{len(files)}] {file.name}')
subprocess.run([
'ffmpeg', '-y', '-i', str(file),
'-vn', '-c:a', 'libmp3lame',
'-b:a', bitrate,
str(output)
], capture_output=true)
batch_convert_to_mp3('./videos', './audios')-y 参数自动覆盖已有文件，避免交互式确认导致脚本卡住。这在批量处理时几乎必加。
五、几个常见的错误及处理
1. ffmpeg 不在 path 里
windows 上最容易遇到。建议在脚本开头检查：
import shutil
ffmpeg_path = shutil.which('ffmpeg')
if not ffmpeg_path:
raise runtimeerror('未找到 ffmpeg，请确认已安装并加入系统 path')2. 输入文件被占用
windows 上如果文件正在被其他程序使用（比如你刚用播放器打开了它），ffmpeg 会报 permission denied。建议操作前先尝试用只读模式打开文件确认没被锁：
def is_file_locked(filepath):
try:
with open(filepath, 'rb') as f:
return false
except permissionerror:
return true3. 中文字符路径
windows 下路径包含中文时，建议用 path 对象的 resolve() 获取绝对路径传给 ffmpeg，避免编码问题。
4. 进度信息解析失败
不同版本的 ffmpeg 输出的进度格式可能有细微差异。建议做两层匹配，先试新版格式再试旧版：
match = re.search(r'out_time_us=(\d+)', line)
if not match:
match = re.search(r'time=(\d+):(\d+):(\d+)\.(\d+)', line)总结
python 调 ffmpeg 的核心模式就三个：subprocess.run 跑一次性任务、popen 读进度、配合 pathlib 做批量。大部分坑都出在路径编码、超时处理、文件锁这三个地方，写脚本时注意绕开就行。
以上就是python调用ffmpeg处理音视频文件的几种方式的详细内容，更多关于python ffmpeg处理音视频文件的资料请关注代码网其它相关文章！
发表评论