MacOS环境下安装PyQt5失败：sipbuild.pyproject.PyProjectOptionException错误解决求助

我之前在Mac上折腾PyQt5安装时碰到过一模一样的问题，主要是系统自带Python的版本兼容性、构建工具依赖冲突，还有Qt环境没配置好导致的，给你几个亲测有效的解决办法：

方案一：用Homebrew安装（最省心，避免编译问题） #

Homebrew会帮你自动处理所有依赖和环境配置，比pip安装稳定太多：

• 先更新Homebrew到最新版本：

  brew update
  

• 先安装Qt（PyQt5的核心依赖库）：

  brew install qt
  

• 再安装PyQt5：

  brew install pyqt5
  

• 前置清理：如果之前用pip装过PyQt5或sip残留包，先卸载避免冲突：

  pip uninstall -y pyqt5 sip
  

方案二：用pyenv隔离Python环境（解决版本兼容问题） #

Mac自带的Python 3.8版本太老，和PyQt5的构建工具不兼容，用pyenv换个新点的Python版本就能解决：

• 安装pyenv：

  brew install pyenv
  

• 安装一个兼容的Python版本（比如3.10.x，亲测和PyQt5 5.15.x完美适配）：

  pyenv install 3.10.12
  

• 让当前终端会话使用这个Python版本：

  pyenv shell 3.10.12
  

• 升级pip和构建工具：

  pip install --upgrade pip setuptools wheel
  

• 最后安装PyQt5：

  pip install pyqt5
  

方案三：手动修复sip依赖（针对PEP 518规范错误） #

你提到安装旧版本PyQt5时出现build-system.requires无效依赖的问题，这是因为sip版本不匹配：

• 先卸载旧的sip：

  pip uninstall -y sip
  

• 安装符合要求的sip版本（比如5.5.0，刚好满足>=5.0.1 <6的限制）：

  pip install sip==5.5.0
  

• 确保Qt的qmake工具在系统PATH里（如果是brew装的Qt）：

  export PATH="/usr/local/opt/qt/bin:$PATH"
  

• 再安装对应版本的PyQt5：

  pip install pyqt5==5.15.4
  

额外排查点 #

• 确保Xcode命令行工具已安装：xcode-select --install，PyQt编译需要用到它
• 绝对不要用sudo pip安装，会污染系统Python环境，优先用用户安装（pip默认的--user）或者pyenv的隔离环境

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