MSYS2/MingGW64安装PyAudio出现c文件编译报错如何解决

报错原因说明 #

你遇到的 /usr/local/include/stdio.h 语法错误不是gcc版本问题，本质是编译链头文件路径冲突：/usr/local/include 是 MSYS2 原生POSIX模拟环境的头文件路径，MinGW64 编译链编译原生Windows程序时不应该检索该路径的头文件，大概率是你手动修改过CPATH等环境变量，或者往 /usr/local/include 放入了非MinGW适配的头文件导致的。

正确安装步骤 #

1. 环境校验 #

• 确认你打开的是 MingGW64 终端，而非MSYS2默认的MSYS终端，两个环境的编译链、库路径完全独立，混用必然报错
• 先更新系统所有包到最新版本：

  pacman -Syu
  

  执行后如果提示需要重启终端，关闭终端重开后再执行一次pacman -Syu完成全量更新

2. 安装依赖 #

执行以下命令安装基础编译依赖和PortAudio库：

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-python-pip mingw-w64-x86_64-python-setuptools mingw-w64-x86_64-wheel mingw-w64-x86_64-portaudio

注意不要安装msys2仓库下的portaudio包，仅安装前缀为mingw-w64-x86_64-的MinGW适配版本

3. 安装PyAudio #

优先使用pip直接安装，避免手动编译的坑：

export CPATH=/mingw64/include
export LIBRARY_PATH=/mingw64/lib
pip install pyaudio --no-cache-dir

如果需要手动编译源码，进入源码目录后先执行上面两行export命令指定头文件、库文件检索路径，再执行python setup.py build即可，避免编译链检索到/usr/local/include下的冲突头文件

关于Microsoft Visual C++ Redistributable的说明 #

• 安装PyAudio的过程中不需要该组件，整个流程使用MinGW的GCC编译链，依赖GNU生态的运行库，和微软VC++运行库无关
• 仅当你后续将PyAudio编写的程序打包分发到没有MinGW环境的Windows设备时，可能需要根据打包配置安装对应版本的VC++ Redistributable，纯本地开发无需额外安装

残留问题排查 #

如果仍然报stdio.h语法错误，执行echo $CPATH检查输出是否包含/usr/local/include，如果存在执行unset CPATH清空自定义头文件路径后再重试编译即可。

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