Mac下pip安装pyFFTW失败：无法检测到已安装的FFTW库

问题描述 #

通过Homebrew成功安装FFTW（路径/opt/homebrew/Cellar/fftw）后，执行pip install pyfftw出现编译失败，核心报错为找不到FFTW库，关键错误信息如下：

/var/folders/tq/nyll_l_92r94p57ry8z60bd80000gq/T/pyfftw-yym3ktj2/fftwl_plan_dft.c:2:17: error: call to undeclared function 'fftwl_plan_dft'; ISO C99 and later do not support implicit function declarations [-Wimplicit-function-declaration]
fftwl_plan_dft();
^
1 error generated.
WARNING:main:Compilation error: command '/usr/bin/clang' failed with exit code 1
...
DEBUG:main:{'HAVE_DOUBLE': False, ..., 'HAVE_MPI': False}
error: Could not find any of the FFTW libraries

已尝试设置临时环境变量但未解决问题：

export DYLD_LIBRARY_PATH=/opt/homebrew/Cellar/fftw/3.3.10_1/lib/
export LDFLAGS="-L/opt/homebrew/Cellar/fftw/3.3.10_1/lib/"
export CFLAGS="-I/opt/homebrew/Cellar/fftw/3.3.10_1/include/"

locate libfftw确认库存在于/opt/homebrew/lib/和/opt/homebrew/Cellar/fftw/3.3.10_1/lib/目录。

解决方案 #

1. 安装完整FFTW变体 #

Homebrew默认安装的FFTW可能缺少long double等必要变体，需安装全功能版本：

# 旧版Homebrew命令
brew install fftw --with-all
# 新版Homebrew命令
brew install fftw --enable-all

2. 使用Homebrew标准链接路径设置环境变量 #

直接用Homebrew的全局链接路径（而非Cellar内部路径）配置环境变量，确保编译工具能正确找到库：

export LDFLAGS="-L/opt/homebrew/lib"
export CFLAGS="-I/opt/homebrew/include"
export CPATH="/opt/homebrew/include"
export LIBRARY_PATH="/opt/homebrew/lib"

设置完成后重新执行pip install pyfftw

3. 手动指定FFTW库变体 #

若上述方法无效，安装时明确指定要链接的FFTW库：

pip install pyfftw --install-option="--fftw-libs=fftw3,fftw3f,fftw3l"

4. 切换到conda安装（替代方案） #

跳过编译步骤，直接安装conda预编译版本：

conda install -c conda-forge pyfftw

5. 检查架构匹配性 #

确保Python环境（如anaconda）与FFTW库的CPU架构一致（均为arm64或x86_64）：

# 检查Python架构
python -c "import platform; print(platform.machine())"
# 检查FFTW库架构
lipo -info /opt/homebrew/lib/libfftw3.dylib

若架构不匹配，可通过Rosetta打开终端切换到对应架构的Python环境后重试。

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