FFmpeg命令在cmd/PowerShell正常运行，Python调用执行异常如何解决？

核心原因 #

报错本质是两类问题：

1. Python子进程的环境变量PATH和手动打开的终端PATH不一致，找不到FFmpeg的可执行文件
2. Windows路径的转义符解析错误，或多余的shell封装导致命令解析异常

可直接落地的解决步骤 #

• 第一步：获取FFmpeg的绝对路径
  打开你正常执行命令的PowerShell，执行where.exe ffmpeg，会输出FFmpeg的完整路径，例如：C:\dev\ffmpeg\bin\ffmpeg.exe，后续直接用该完整路径调用，避免PATH查找失败问题。
• 第二步：使用正确的subprocess调用写法
  不要额外嵌套PowerShell层，直接用列表参数调用FFmpeg，同时处理路径转义，推荐写法如下：

  import subprocess
  import os
  
  # 替换为你自己的FFmpeg绝对路径
  FFMPEG_PATH = r'C:\dev\ffmpeg\bin\ffmpeg.exe'
  parent_dir = r'C:\YTDownloads'
  newname = 'CurrentAudio'
  
  input_path = os.path.join(parent_dir, f"{newname}.3gpp")
  output_path = os.path.join(parent_dir, f"{newname}.mp3")
  
  # 执行转换命令
  result = subprocess.run(
      [FFMPEG_PATH, "-i", input_path, output_path],
      capture_output=True,
      text=True,
      check=True
  )
  

• 第三步：异常排查
  如果执行失败，可通过捕获异常查看FFmpeg的具体报错信息：

  try:
      subprocess.run(
          [FFMPEG_PATH, "-i", input_path, output_path],
          capture_output=True,
          text=True,
          check=True
      )
  except subprocess.CalledProcessError as e:
      print("转换失败，错误信息：", e.stderr)
  

可选优化方案 #

如果你不想写死FFmpeg绝对路径，可在调用前手动将FFmpeg所在的bin目录加入当前Python进程的环境变量：

import os
# 替换为你的FFmpeg bin目录路径
os.environ['PATH'] += r';C:\dev\ffmpeg\bin'

之后调用时直接写'ffmpeg'即可。

内容的提问来源于stack exchange，提问作者Gustavo Marinho