pip安装essentia时报Building wheel for essentia (setup.py)错误如何解决

报错原因 #

该报错是由于pip默认拉取essentia源码包进行本地编译，本地环境缺少C++编译工具链、FFTW、FFmpeg等底层音频依赖，导致源码编译失败。Windows环境下该问题出现概率最高。

解决方案 #

• 方案一：Anaconda环境优先使用conda预编译包安装（适配全平台，无编译报错）
  执行命令：
  conda install -c conda-forge essentia
  conda会自动处理所有依赖项，无需手动配置编译环境。
• 方案二：坚持使用pip安装的情况，需先提前安装系统级依赖
  • Linux（Debian/Ubuntu系列）：
    先执行系统依赖安装命令：
    sudo apt-get install build-essential libyaml-dev libfftw3-dev libavcodec-dev libavformat-dev libavutil-dev libswresample-dev libsamplerate0-dev libtag1-dev
    完成后再执行pip install essentia
  • macOS：
    先通过Homebrew安装依赖：
    brew install fftw libsamplerate libtag yaml-cpp ffmpeg
    完成后再执行pip install essentia
  • Windows：
    不推荐使用pip源码安装，必须使用pip的话需要先安装完整Visual Studio C++桌面开发工具集，手动配置FFmpeg、FFTW等依赖库后再尝试安装，成功率较低。

安装验证 #

安装完成后执行以下命令验证是否安装成功：
python -c "import essentia; print(essentia.__version__)"
正常输出版本号即为安装成功。

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