如何在WSL2中用QEMU+Docker构建aarch64架构Python lap包Wheel

核心问题拆解 #

你碰到的两个错误本质和qemu-aarch64-static传入无关：

• 平台不匹配警告：Docker未明确指定目标平台，导致检测到主机与镜像架构不一致
• setup.py找不到：容器默认工作目录不是挂载的/io，相对路径无法定位文件

你之前完成的qemu注册步骤已经生效，Docker会自动调用qemu完成aarch64仿真，无需手动传入qemu-aarch64-static。

修复后的构建命令 #

直接使用以下命令即可解决问题，同时消除警告并定位到正确的文件路径：

docker run --rm --platform linux/arm64/v8 -v "$(pwd)":/io quay.io/pypa/manylinux2014_aarch64 bash -c 'cd /io && /opt/python/cp38-cp38/bin/python setup.py bdist_wheel'

命令说明 #

• --platform linux/arm64/v8：明确指定容器运行的目标架构，消除平台不匹配警告
• cd /io：切换到挂载的主机目录，确保setup.py可以被相对路径找到
• -v "$(pwd)":/io：将主机当前目录挂载到容器内的/io路径

额外优化建议 #

1. 确认文件存在：执行命令前先在主机当前目录运行ls setup.py，确保文件确实存在
2. 处理编译依赖：如果构建时出现缺失编译器或依赖库的错误，可在命令中添加依赖安装步骤：

   docker run --rm --platform linux/arm64/v8 -v "$(pwd)":/io quay.io/pypa/manylinux2014_aarch64 bash -c 'yum install -y gcc make && cd /io && /opt/python/cp38-cp38/bin/python setup.py bdist_wheel'
   

3. 验证结果：构建完成后，主机当前目录的dist文件夹会生成带有aarch64标识的Wheel文件，可直接用于Buildroot环境。

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