本文详解如何在 Python 中正确安装和使用 ffmpeg-python 库进行视频剪辑、翻转、格式转换等基础编辑操作，并重点解决常见的 AttributeError: module 'ffmpeg' has no attribute 'input' 错误。
本文详解如何在 python 中正确安装和使用 `ffmpeg-python` 库进行视频剪辑、翻转、格式转换等基础编辑操作，并重点解决常见的 `attributeerror: module 'ffmpeg' has no attribute 'input'` 错误。
在 Python 生态中，ffmpeg-python 是最常用、最轻量且功能强大的 FFmpeg 封装库之一，它通过声明式语法构建 FFmpeg 命令流，无需手动拼接字符串，既安全又可读性强。但初学者常因安装错误导致核心函数（如 ffmpeg.input()）不可用——这并非代码问题，而是混淆了同名但完全无关的 PyPI 包。
✅ 正确安装：避免“假 ffmpeg”
最常见的错误是执行了 pip install ffmpeg（该包仅提供一个空模块，无任何功能），而非官方维护的 ffmpeg-python：
# ❌ 错误安装（会导致 AttributeError） pip install ffmpeg # ✅ 正确安装（推荐） pip install ffmpeg-python # 验证安装是否成功 pip list | grep -i ffmpeg # 应输出类似：ffmpeg-python 0.2.0
安装后，可通过以下代码快速验证模块完整性：
import ffmpeg print(ffmpeg) # 查看模块路径，例如：<module 'ffmpeg' from '/path/to/site-packages/ffmpeg/__init__.py'> # 检查关键函数是否存在 print(hasattr(ffmpeg, 'input')) # 应输出 True print(hasattr(ffmpeg, 'hflip')) # 应输出 True
若 hasattr(ffmpeg, 'input') 返回 False，说明你仍加载了错误的 ffmpeg 包，请卸载并重装：
立即学习“Python免费学习笔记（深入）”；
pip uninstall ffmpeg -y pip install ffmpeg-python
? 基础视频编辑示例
确保环境就绪后，即可开始编辑。以下是一个完整、可运行的示例：对 MP4 视频进行水平翻转（镜像）、调整分辨率并导出为新文件：
import ffmpeg
# 1. 定义输入流
input_stream = ffmpeg.input('input.mp4')
# 2. 构建处理链：水平翻转 + 缩放至 720p（保持宽高比）
processed = (
input_stream
.hflip() # 水平翻转
.filter('scale', '1280:-2') # 宽设为1280，高度自动适配（-2 表示保持宽高比）
)
# 3. 定义输出（自动推断编码器与封装格式）
output_stream = ffmpeg.output(processed, 'output_flipped_720p.mp4')
# 4. 执行命令（等效于终端运行 ffmpeg -i input.mp4 -vf "hflip,scale=1280:-2" output_flipped_720p.mp4）
ffmpeg.run(output_stream, overwrite_output=True)? 提示：ffmpeg.run() 默认静默执行；添加 capture_stdout=True 或 capture_stderr=True 可捕获日志用于调试。
⚠️ 注意事项与最佳实践
- FFmpeg 二进制依赖：ffmpeg-python 本身不包含 FFmpeg 可执行文件，需系统已安装 FFmpeg（Windows 用户建议使用 choco install ffmpeg 或下载静态 build；macOS 推荐 brew install ffmpeg；Linux 使用 apt install ffmpeg）。
- 路径与权限：确保输入文件路径正确，且 Python 进程有读写输出目录的权限。
- 性能优化：复杂滤镜链建议使用 .global_args('-threads', '4') 显式指定线程数；对大视频可添加 -preset fast 提升编码速度（通过 .output(..., preset='fast')）。
- 错误处理：生产环境中应包裹 try/except ffmpeg.Error 并检查 e.stdout / e.stderr 输出以定位编解码失败原因。
✅ 总结
ffmpeg-python 是 Python 视频自动化处理的利器，但其易用性建立在正确安装 ffmpeg-python（非 ffmpeg） 的前提之上。一旦环境配置无误，你就能以清晰、函数式的方式组合滤镜、音频流与编码参数，实现从简单翻转到多轨道合成的各类编辑任务。记住三步口诀：装对包、验属性、链流跑——从此告别 AttributeError，高效进入视频处理实战。
