Mac环境下PyCharm配置pyenv Python解释器及库安装问题

问题背景 #

• 首次使用Mac上的PyCharm创建项目时，因未配置解释器出现<No interpreter>错误；配置系统默认Python（/usr/bin/python3）后可运行代码，但无法安装PyQt5
• 通过Homebrew安装pyenv并下载Python 3.11.0，将其配置为PyCharm解释器后仍无法安装第三方库，核心报错如下：

error: subprocess-exited-with-error
× Preparing metadata (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [33 lines of output]
Traceback (most recent call last):
File "/Users//.pyenv/versions/3.11.0/lib/python3.11/site-packages/pip/_vendor/pep517/in_process/_in_process.py", line 144, in prepare_metadata_for_build_wheel
hook = backend.prepare_metadata_for_build_wheel
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: module 'sipbuild.api' has no attribute 'prepare_metadata_for_build_wheel'

解决步骤 #

1. 验证并修复pyenv环境配置 #

• 打开终端，执行以下命令检查pyenv路径优先级：

  echo $PATH
  

  确认输出中/Users/<username>/.pyenv/shims位于系统Python路径（如/usr/bin）之前
• 若路径未正确加载，将以下内容添加到~/.zshrc（zsh用户）或~/.bash_profile（bash用户）：

  export PYENV_ROOT="$HOME/.pyenv"
  export PATH="$PYENV_ROOT/shims:$PATH"
  eval "$(pyenv init -)"
  

  执行source ~/.zshrc（或对应配置文件）使配置生效

2. 重新安装Python 3.11.0并补全编译依赖 #

• 卸载现有Python 3.11.0：

  pyenv uninstall 3.11.0
  

• 安装Python编译所需的系统依赖：

  brew install openssl readline sqlite3 xz zlib
  

• 重新安装Python 3.11.0：

  pyenv install 3.11.0
  

• 设置当前项目使用该版本：

  cd <你的项目目录>
  pyenv local 3.11.0
  

3. 更新pip并正确安装PyQt5依赖 #

• 更新pip、setuptools和wheel到最新版本：

  python -m pip install --upgrade pip setuptools wheel
  

• 安装匹配版本的sip（PyQt5的核心依赖库）：

  pip install sip==6.7.7
  

• 安装PyQt5：

  pip install PyQt5
  

4. 在PyCharm中重新配置解释器 #

• 打开PyCharm，进入File > Settings > Project: <项目名称> > Python Interpreter
• 点击右上角齿轮图标，选择Add
• 选择System Interpreter，浏览并选择路径/Users/<username>/.pyenv/versions/3.11.0/bin/python3
• 确认后等待PyCharm同步解释器信息，之后即可正常安装和使用第三方库

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