Windows10下Python3.10安装PySide2报错找不到匹配版本如何解决

报错内容 #

ERROR: Could not find a version that satisfies the requirement PySide2 (from versions: none)
ERROR: No matching distribution found for PySide2

报错原因 #

官方PySide2未提供适配Python3.10及更高版本的Windows预编译安装包，PySide2的官方支持最高到Python3.9版本，因此pip无法找到匹配的安装源。

可用解决方案 #

• 方案1：更换兼容的Python版本（最稳定） #

  卸载当前Python3.10环境，安装Python3.8或Python3.9版本，之后重新执行pip install PySide2即可完成正常安装。

• 方案2：手动安装非官方预编译包 #

  获取对应Python3.10、Windows系统、匹配CPU架构的PySide2 .whl格式安装包，打开命令行进入安装包所在目录，执行pip install [whl包完整文件名]完成安装。
  注意：非官方编译包未经过官方全量验证，可能存在兼容性或稳定性风险

• 方案3：迁移至PySide6（推荐） #

  PySide6是Qt官方后续迭代维护的版本，完美适配Python3.10及更高版本，API和PySide2差异极小，仅需调整少量导入语句即可完成代码迁移，直接执行pip install PySide6即可完成安装。

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