MacOS安装PyAudio提示'Python.h'文件缺失，求解决方法

核心原因 #

Python.h是Python开发库的核心头文件，macOS环境下若未安装Python开发组件或编译路径未正确指向头文件目录，就会触发该报错。

解决方案 #

• 安装Xcode命令行工具（编译依赖）
  执行以下命令安装或更新Xcode命令行工具：

  xcode-select --install
  

  若已安装，会弹出提示说明无需操作。

• 自动识别Python头文件路径并安装
  用Python内置命令获取准确的头文件目录，同时结合PortAudio的路径进行编译安装：

  CFLAGS="-I$(python3 -c 'import sysconfig; print(sysconfig.get_path("include"))') -I$(brew --prefix portaudio)/include" LDFLAGS="-L$(brew --prefix portaudio)/lib" pip3 install PyAudio==0.2.12
  

• 手动指定Python版本的头文件路径（备选）
  如果你明确知道Python版本的安装路径，比如Python3.9的头文件在/Library/Frameworks/Python.framework/Versions/3.9/include/python3.9，可直接指定：

  CFLAGS="-I/Library/Frameworks/Python.framework/Versions/3.9/include/python3.9 -I$(brew --prefix portaudio)/include" LDFLAGS="-L$(brew --prefix portaudio)/lib" pip3 install PyAudio==0.2.12
  

• 尝试安装预编译轮子（避免编译）
  如果上述编译方式仍失败，可尝试直接安装预编译的二进制包：

  pip3 install --only-binary :all: PyAudio==0.2.12
  

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