python: can't open file 'ffmpeg': [Errno 2] No such file or directory

### Python 中执行 FFmpeg 命令报错 `Errno 2` 的原因分析

当尝试通过 Python 调用 FFmpeg 并遇到错误 `FileNotFoundError: [Errno 2] No such file or directory` 时，这通常意味着操作系统无法找到指定的文件路径或程序[^1]。

具体来说，在调用外部命令如 FFmpeg 时，如果该命令未安装或不在系统的环境变量 PATH 中，则会触发此异常。此外，也可能是由于指定了不正确的文件路径所致[^2]。

### 解决方案概述

为了有效处理此类问题，可以采取以下措施：

#### 确认 FFmpeg 安装状态
确保 FFmpeg 已正确安装并配置到系统环境中。可以通过终端输入 `ffmpeg -version` 来验证其是否存在以及版本信息。如果没有返回有效的 FFmpeg 版本号，则说明需要重新下载并安装最新版 FFmpeg[^5]。

#### 设置绝对路径
对于特定情况下仅某台机器上报错的情况，考虑使用 FFmpeg 的完整路径来代替默认名称 "ffmpeg" 进行调用。例如：

import subprocess

subprocess.run(['/usr/local/bin/ffmpeg', '-i', 'input.mp4', 'output.avi'])

#### 添加至环境变量
另一种方法是在运行脚本之前临时向环境变量中添加 FFmpeg 可执行文件的位置。这样可以在不需要修改现有代码的情况下使 FFmpeg 成为可全局访问的服务。

export PATH=$PATH:/path/to/ffmpeg/directory

#### 使用第三方库简化操作
考虑到跨平台兼容性和易用性的需求，推荐采用专门用于封装 FFmovie 功能的 Python 库——`ffmpy` 或者 `moviepy`，这些库能够自动管理依赖关系，并提供更友好的 API 接口[^3]。

### 示例代码片段展示如何安全地调用 FFmpeg
下面给出一段利用 try-except 结构捕获潜在 IO 错误的例子，同时包含了设置相对路径的方式作为备选方案之一：

from pathlib import Path
import os
try:
    # 尝试直接调用 ffmpeg
    result = subprocess.run(['ffmpeg', '-i', str(Path('relative/path/to/input').resolve()), 'output'], check=True)

except FileNotFoundError as e:
    print(f"FFmpeg 不可用：{e}")
    
    # 如果失败则切换成绝对路径模式重试一次
    abs_ffmpeg_path = "/absolute/path/to/ffmpeg"
    if os.path.exists(abs_ffmpeg_path):
        result = subprocess.run([abs_ffmpeg_path, '-i', str(Path('relative/path/to/input').resolve()), 'output'], check=True)
    else:
        raise Exception("未能定位 FFmpeg")