PyCharm中subprocess调用ffmpeg路径问题及应用部署方案咨询

问题场景 #

在PyCharm中使用subprocess调用FFmpeg转换MP3到WAV时，直接执行以下代码会提示找不到文件：

import subprocess
subprocess.call(['ffmpeg', '-i','test.mp3','test.wav'])

替换为FFmpeg本地绝对路径后可正常运行，但开发面向其他用户的应用时，无法预知FFmpeg的存放路径。尝试以下方法遇阻：

• 错误调用os.path('ffmpeg.exe')触发TypeError: 'module' object is not callable（os.path是模块而非函数）
• 使用shutil.which()返回None（已确认本地安装FFmpeg）

解决方案 #

一、动态获取FFmpeg路径 #

1. 遍历系统PATH环境变量查找

通过遍历系统PATH中的所有路径，检查FFmpeg可执行文件是否存在且可执行：

import os
import subprocess

def find_ffmpeg():
    # 遍历系统PATH环境变量的所有路径
    for path in os.environ['PATH'].split(os.pathsep):
        ffmpeg_exe = os.path.join(path, 'ffmpeg.exe')
        # 检查文件存在且有执行权限
        if os.path.exists(ffmpeg_exe) and os.access(ffmpeg_exe, os.X_OK):
            return ffmpeg_exe
    return None

ffmpeg_path = find_ffmpeg()
if ffmpeg_path:
    subprocess.call([ffmpeg_path, '-i','test.mp3','test.wav'])
else:
    print("未找到FFmpeg，请将其添加到系统PATH，或手动指定路径")

2. 排查shutil.which()返回None的问题

• 确认FFmpeg所在路径已添加到系统PATH环境变量，添加后需重启PyCharm（PyCharm启动时读取环境变量，修改后需重启生效）
• 若用户可能将FFmpeg放在常用目录，可手动指定搜索路径：

import shutil
import os

possible_paths = ['C:/ffmpeg/bin', 'D:/tools/ffmpeg/bin', os.path.expanduser('~/ffmpeg/bin')]
ffmpeg_path = None

for path in possible_paths:
    candidate = os.path.join(path, 'ffmpeg.exe')
    if shutil.which(candidate):
        ffmpeg_path = candidate
        break

if ffmpeg_path:
    print(f"找到FFmpeg：{ffmpeg_path}")
else:
    print("未找到FFmpeg，请检查安装路径")

二、将FFmpeg随应用打包到指定路径 #

如果希望用户无需单独安装FFmpeg，可将FFmpeg二进制文件与应用一同打包：

1. 在项目根目录创建bin文件夹，放入对应操作系统的FFmpeg可执行文件（Windows为ffmpeg.exe，Linux/macOS为ffmpeg）
2. 通过相对路径调用FFmpeg：

import os
import subprocess

# 获取当前脚本所在目录，拼接FFmpeg路径
script_dir = os.path.dirname(os.path.abspath(__file__))
ffmpeg_path = os.path.join(script_dir, 'bin', 'ffmpeg.exe')

if os.path.exists(ffmpeg_path):
    subprocess.call([ffmpeg_path, '-i','test.mp3','test.wav'])
else:
    print("应用目录下未找到FFmpeg，请检查bin文件夹是否包含对应可执行文件")

3. 打包应用时（如使用PyInstaller），需将bin文件夹包含到打包产物中：
   • Windows系统：执行pyinstaller --add-data "bin/ffmpeg.exe;bin" your_script.py
   • Linux/macOS系统：执行pyinstaller --add-data "bin/ffmpeg:bin" your_script.py

内容的提问来源于stack exchange，提问作者Percy Yang