树莓派安装PyQt5卡在Preparing Wheel metadata环节的问题求助

树莓派为ARM架构，PyQt5在官方PyPI源中没有适配通用ARM平台的预编译安装包，直接执行sudo pip3 install pyqt5时，pip会自动拉取源码包调用本地编译器完成全模块编译。树莓派硬件算力有限的场景下，这个编译流程耗时本就较长，结合进度持续变动的状态判断，不属于程序崩溃，是源码编译过程的正常表现。

• 优先更换为树莓派官方软件源的预编译PyQt5包安装，完全绕开本地编译流程：先执行sudo apt update同步源索引，再运行sudo apt install python3-pyqt5完成安装。这类安装包是官方针对树莓派硬件做过适配优化的，安装时仅需拉取二进制文件，通常数分钟即可完成，还会自动配置所有系统层面的Qt运行依赖。
• 若需使用pip渠道发布的PyQt5版本，先按Ctrl+C终止当前卡住的安装进程，提前补全编译必需的系统依赖：执行sudo apt install build-essential python3-dev qtbase5-dev libqt5opengl5-dev，依赖配置完成后重新运行安装命令，建议加上-v参数输出实时编译日志，比如sudo pip3 install pyqt5 -v，可以直观看到当前正在编译的具体模块，避免对着无意义的动态进度条空等；如果树莓派物理内存小于2G，建议临时将swap分区扩容到4G以上，避免内存不足触发的频繁磁盘换页大幅拖慢编译速度。
• 先将pip升级到最新版本再尝试安装：旧版本pip在ARM平台的依赖解析逻辑存在缺陷，会反复遍历检索不兼容的包版本，出现进度条持续变动但无实质安装进展的情况，可先运行sudo pip3 install --upgrade pip完成版本升级后，再执行PyQt5的安装操作。

• 检查SD卡剩余存储空间：PyQt5源码编译过程中需要生成约2~3G的临时文件，如果剩余存储空间不足，pip会在写入临时文件时反复重试，出现进度条持续变动但无实质进展的假状态。
• 校验系统与pip的架构匹配度：如果树莓派运行32位Raspberry Pi OS，需要确保pip3默认拉取的是32位适配的安装包，架构不匹配时pip会跨架构检索不存在的包版本，会出现长时间无下载实质进展的情况。

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