PyCharm安装PyQt5失败求助：metadata生成错误解析

错误原因 #

从报错信息里的sipbuild.pyproject.PyProjectOptionException（关联qmake）来看，核心问题有两个：

1. 环境中缺少Qt的qmake构建工具，导致pip尝试从源码编译PyQt5时无法完成元数据生成。
2. 你使用的Python3.11和PyQt5.15.9存在兼容性问题，该版本的PyQt5对Python3.11的支持不完善。

另外之前pip安装未被识别，大概率是因为操作时未激活目标虚拟环境，导致包安装到了全局Python而非项目的虚拟环境中。

解决步骤 #

• 强制安装预编译二进制包（推荐，避免源码编译）
  激活项目虚拟环境后执行命令：

  pip install PyQt5 --only-binary :all:
  

  或者指定兼容Python3.11的PyQt5版本：

  pip install PyQt5==5.15.10
  

• 若需源码编译（不推荐）

  1. 安装Qt开发环境，确保qmake工具添加到系统PATH中，可通过终端执行qmake --version验证是否配置成功。
  2. 重启IDE或终端，让PATH配置生效后再尝试安装。

• 确认虚拟环境配置
  检查IDE中选择的Python解释器是否为项目对应的虚拟环境，激活虚拟环境后再执行pip命令，避免包安装到全局环境导致IDE无法识别。

报错信息 #

Collecting PyQt5
  Using cached PyQt5-5.15.9.tar.gz (3.2 MB)
  Installing build dependencies: started
  Installing build dependencies: finished with status 'done'
  Getting requirements to build wheel: started
  Getting requirements to build wheel: finished with status 'done'
  Preparing metadata (pyproject.toml): started
  Preparing metadata (pyproject.toml): finished with status 'error'

  error: subprocess-exited-with-error
  
  × Preparing metadata (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [25 lines of output]
      Traceback (most recent call last):
        File "/Users/mistotic/Documents/pythonProject/venv/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 353, in <module>
          main()
        File "/Users/mistotic/Documents/pythonProject/venv/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 335, in main
          json_out['return_val'] = hook(**hook_input['kwargs'])
                                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/Users/mistotic/Documents/pythonProject/venv/lib/python3.11/site-packages/pip/_vendor/pyproject_hooks/_in_process/_in_process.py", line 152, in prepare_metadata_for_build_wheel
          whl_basename = backend.build_wheel(metadata_directory, config_settings)
                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/sipbuild/api.py", line 46, in build_wheel
          project = AbstractProject.bootstrap('wheel',
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/sipbuild/abstract_project.py", line 87, in bootstrap
          project.setup(pyproject, tool, tool_description)
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/sipbuild/project.py", line 586, in setup
          self.apply_user_defaults(tool)
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-install-k7dhkaq6/pyqt5_0b195843befd40e487ae8516705cb7f2/project.py", line 68, in apply_user_defaults
          super().apply_user_defaults(tool)
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/pyqtbuild/project.py", line 70, in apply_user_defaults
          super().apply_user_defaults(tool)
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/sipbuild/project.py", line 237, in apply_user_defaults
          self.builder.apply_user_defaults(tool)
        File "/private/var/folders/c_/s7gtqr3j15x7cxvktp3g3zqw0000gn/T/pip-build-env-754af7_z/overlay/lib/python3.11/site-packages/pyqtbuild/builder.py", line 69, in apply_user_defaults
          raise PyProjectOptionException('qmake',
      sipbuild.pyproject.PyProjectOptionException
      [end of output]
  
  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

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