Python音视频库（如pydub、ffmpeg-python）在macOS上失败主因是系统级ffmpeg未正确安装并加入PATH；需用Homebrew或官网静态包安装ffmpeg本体，配置对应shell的环境变量，新开终端验证which ffmpeg和ffmpeg -version。
Python音视频处理（如pydub、ffmpeg-python）在macOS上跑不起来，90%是因为系统级ffmpeg没配对——不是pip install就能解决的事。
ffmpeg本体必须装在系统PATH里，不是装Python包
pydub、ffmpeg-python这些库本身不带ffmpeg二进制文件，它们只是“指挥官”，真正干活的是你系统里那个ffmpeg命令。如果终端敲ffmpeg -version报command not found，Python调用必然失败。
- 别 pip install ffmpeg：这个包是空壳，装了也没用
- 正确做法是先装系统级ffmpeg，再装
ffmpeg-python或pydub - Homebrew安装最省事：
brew install ffmpeg（推荐M1/M2芯片用户） - 若brew卡住或失败（国内网络常见），改用官网静态包：下载
Static builds for macOS 64-bit，解压后把ffmpeg可执行文件所在目录（通常是bin/）加进PATH
PATH配置要匹配你的shell（bash/zsh）
macOS Catalina之后默认用zsh，但老系统或升级用户可能还是bash。错配会导致环境变量只在当前终端生效，重启就失效。
- 查当前shell：
echo $SHELL，输出/bin/zsh就配~/.zshrc，输出/bin/bash就配~/.bash_profile - 加PATH示例（以zsh为例）：
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证是否生效：
which ffmpeg应返回路径，ffmpeg -version能打印版本号
pydub和ffmpeg-python的调用差异要分清
两者都依赖系统ffmpeg，但触发时机和报错表现不同，容易混淆。
立即学习“Python免费学习笔记（深入）”；
-
pydub：读MP3/OGG时才去PATH里找ffmpeg或avconv；读WAV不依赖外部程序。报错是RuntimeWarning: Couldn't find ffmpeg or avconv -
ffmpeg-python：调用.run()时才真正执行命令；未配置PATH时直接抛OSError: [Errno 2] No such file or directory - 注意：
ffmpeg-python的_run.py里硬编码了查找逻辑，但新版已基本不需要手动改路径——只要which ffmpeg能定位到，它就能用
最容易被忽略的一点：ffmpeg安装后必须新开一个终端窗口验证，而不是在当前已打开的终端里反复source。很多“明明配了PATH却还是找不到”的问题，根源就在这一步。
