MacBook安装spacepy、cdf、pycdf出现wheel构建报错求助

• 运行环境：MacBook Pro
• 安装目标：spacepy、cdf、pycdf
• 已尝试操作：升级pip至最新版本、安装最新版官方Python、安装Anaconda发行版
• 执行pip install spacepy时安装失败，报错信息如下：

ERROR: Could not build wheels for spacepy, which is required to install pyproject.toml-based projects

• 现有公开通用解决方案在当前设备上均无法生效

1. 补全本地编译依赖 #

Mac系统默认缺少Python包编译所需的C/Fortran编译组件，先执行以下命令安装Xcode命令行工具：
xcode-select --install
如果终端提示命令行工具已安装可直接跳过，否则按弹窗引导完成安装即可。
若本地已安装Homebrew，额外执行以下命令补全编译依赖：
brew install gcc fftw numpy

2. 手动安装CDF底层库 #

spacepy的pycdf模块强依赖NASA官方的CDF原生库，pip源没有适配Mac的预编译CDF库，必须手动安装：

• 下载对应Mac芯片架构的CDF库安装包：Apple Silicon（M1/M2/M3系列）选arm64版本，Intel芯片选x86_64版本，按安装引导走默认路径安装即可
• 配置CDF库环境变量，zsh终端（Mac默认终端）依次执行：
  echo 'export CDF_LIB=/usr/local/cdf/lib' >> ~/.zshrc
echo 'export CDF_INC=/usr/local/cdf/include' >> ~/.zshrc
  如果使用bash终端，将上述命令里的~/.zshrc替换为~/.bash_profile即可
• 执行对应命令让环境变量生效：zsh终端执行source ~/.zshrc，bash终端执行source ~/.bash_profile

3. 隔离环境下安装spacepy #

• 激活需要安装组件的conda虚拟环境，先安装预编译的Python依赖，避免重复编译出错：
  conda install numpy scipy matplotlib h5py
• 依赖安装完成后，执行带参数的pip安装命令：
  pip install spacepy --no-build-isolation
  加--no-build-isolation参数是为了让安装过程直接调用当前环境内已装好的依赖，不会创建临时编译环境导致找不到本地CDF库路径。

4. 安装验证 #

终端执行以下命令验证安装结果：
python -c "import spacepy.pycdf"
执行后无导入报错即代表spacepy、cdf、pycdf全部安装正常。

• M系列芯片的MacBook Pro不要用Rosetta转译模式运行终端执行上述操作，会出现CPU架构不匹配的编译错误，使用原生终端即可
• 如果之前有过失败的安装记录，先执行pip uninstall -y spacepy cdf pycdf清理残留包和缓存，再走上述流程，避免旧文件干扰
• 不要直接在Mac系统自带的Python环境下执行安装，系统Python有目录权限限制，优先使用conda创建的独立虚拟环境操作

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