如何使用Nuitka指定进程架构部署PyQt5应用适配树莓派ARM64？

Nuitka 属于AOT原生编译类打包工具，不支持在x64架构环境下直接交叉编译输出ARM架构可执行文件，不存在可以直接指定目标架构为ARM的启动参数——编译过程会直接调用当前系统的原生编译器、链接匹配宿主CPU指令集的系统依赖，在Windows x64环境下打出的包天生只能跑在x64架构设备上，架构不兼容是必然结果，不是参数配置错误。

方案1：树莓派本地打包（兼容性最好，踩坑最少） #

直接把PyQt5项目源码同步到树莓派3上，在设备本地完成打包，步骤如下：

• 先在树莓派上安装系统级依赖，避免PyQt5和编译环境缺失：

sudo apt update && sudo apt install -y python3-pyqt5 python3-pip build-essential cmake patchelf

• 安装最新版Nuitka：

pip3 install --upgrade nuitka

• 执行打包命令，针对ARM架构做体积和速度优化：

python3 -m nuitka --standalone --enable-plugin=pyqt5 --lto=yes --remove-output 你的项目入口.py

• 打包完成后，当前目录下生成的项目入口.dist文件夹就是完整的自包含运行目录，拷贝到同架构、同系统大版本的ARM设备上可以直接运行，不需要额外安装依赖。

方案2：QEMU模拟ARM环境打包（无需占用树莓派硬件） #

如果不想直接在树莓派上编译（树莓派3编译中小型PyQt5项目大概需要5-10分钟，大项目耗时会更长），可以在Windows上通过QEMU运行和树莓派3系统版本、架构完全一致的虚拟机：

• 先在树莓派上执行uname -m确认系统架构：输出armv7l对应32位armhf架构，输出aarch64对应64位arm64架构，下载对应架构的Raspberry Pi OS镜像
• 用QEMU启动该ARM镜像，在虚拟机内安装和树莓派本地一致的Python、PyQt5、Nuitka依赖
• 把源码传入虚拟机，执行和本地打包完全一致的命令即可，输出的包和树莓派本地打包兼容性一致，缺点是模拟环境编译速度比原生硬件慢40%左右。

• 不要尝试在x64环境下强行配置交叉编译工具链给Nuitka用，Nuitka对Python依赖、Qt库的架构一致性校验非常严格，交叉编译的产物90%以上概率会出现缺库、指令集不支持的运行错误，调试成本远高于直接在ARM环境打包。
• 打包PyQt5类项目必须加--enable-plugin=pyqt5参数，否则会漏带Qt平台插件、主题依赖，运行时会直接报could not load the qt platform plugin "xcb"的错误。
• 如果需要单文件输出，可以在打包命令里加--onefile参数，但是PyQt5项目单文件启动速度会比文件夹模式慢2-3秒，根据需求选择即可。

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