当前位置：首页>python>借助Docker离线搭建银河麒麟Python 环境(三):Docker 编译 PyQt5 + PyQt5 运行时库打包

借助Docker离线搭建银河麒麟Python 环境(三):Docker 编译 PyQt5 + PyQt5 运行时库打包

2026-07-02 16:30:08

摘要：
国产化替代浪潮下，很多项目需要部署在麒麟 V10 （飞腾处理器aarch64）上运行。这些系统通常处于内网环境，无法直接联网安装 Python 依赖。本系列文章提供一套完整方案，在 Windows 上借助 Docker 模拟 aarch64 环境，完成 Python 版本升级、依赖下载、依赖编译，将产物拷贝到麒麟上部署。
这篇博文介绍：在 Docker 容器中编译 PyQt5 源码，打包编译产物，以及关键的步骤——提取完整的 Qt5 运行时依赖树，确保在麒麟 V10 上部署正确

本系列包含四篇文章：

第 1 篇：docker环境准备和升级 Python版本

第 2 篇：Docker 打包带依赖的 Python 环境

第 3 篇（本文）：Docker 编译 PyQt5 + PyQt5 运行时库打包

上文回顾

在前两篇文章中，我们完成了：

第一篇：在 Windows 上搭建 Docker ARM64 环境，使用 debian:11-slim + python-build-standalone 打包了 Python 3.10.11，在麒麟 V10 上解压即用。
第二篇：在 Docker 容器中安装了 pysnmp、requests 等纯 Python 依赖，重新打包后实现"解压即有全部依赖"，并讲解了 PyCharm 虚拟环境的配置方法。

但那些都是纯 Python 包——它们不包含 C/C++ 代码，下载后直接 import 就能用。如果项目需要 PyQt5（GUI 框架），情况就完全不同了。

本文聚焦：在 Docker 容器中编译 PyQt5 源码，打包编译产物，以及最关键的步骤——提取完整的 Qt5 运行时依赖树，确保在麒麟 V10 上部署后不会出现 undefined symbol 或 cannot open shared object file 错误。

升级资源在文后！！！

特别说明：本人不论在编程还是麒麟系统的使用都是新手，文章供大家讨论，如果大家还有更好、更方便的方法请大家留言指出！

一、 PyQt5 编译安装的原因

原因是官方没有 aarch64 wheel。打开 `https://pypi.org/simple/pyqt5/` ，`Ctrl+F` 搜索 `aarch64`，结果为 0。是因为我没有找到PyQt5 官方发布的 Linux aarch64 的预编译 wheel。这意味着 `pip install PyQt5` 在aarch64 机器上会自动触发源码编译——但麒麟 V10 处于断网环境，且没有安装 Qt5 编译工具链，这条路走不通。

第二是采用APT 版本的局限性。Debian 11 的 APT 源中有 `python3-pyqt5` 预编译包：

python3-pyqt5 - Python 3 bindings for Qt5

但它会绑定到系统的 python3（Debian 11 自带 Python 3.9），而我们的 Python 3.10 是通过 python-build-standalone 独立安装的，两者互不相通。APT 安装的 PyQt5 无法被 Python 3.10 导入。

结论：必须在aarch64 环境中源码编译，Docker aarch64容器提供了完美的编译环境——有完整的 Qt5 开发库、编译工具链，且 glibc 与麒麟 V10 完全匹配。

二、编译环境说明

本篇沿用前两篇的 Docker 环境，编译所需组件如下：

组件	来源	版本
基础镜像	`debian:11-slim`	glibc 2.31
Python	`python-build-standalone`	3.10.11
Qt5 开发库	APT 源（`qtbase5-dev` 等）	5.15.2
SIP	pip	6.15.3
PyQt-builder	pip	1.19.1

前提条件：确保容器中已安装 Python 3.10（参见第一篇文章的）。如果容器已退出，重新启动并安装 Python：

docker run --rm -it --platform linux/arm64 -v D:\pytq-test:/output debian:11-slim

sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.listapt-get updatetar -xzf /output/cpython-3.10.11+20230507-aarch64-unknown-linux-gnu-install_only.tar.gz -C /usr/local --strip-components=1

三、Windows + Docker 操作

3.1 安装 Qt5 编译依赖

# 配置 APT 国内源（如未配置）sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.listapt-get update# 安装 Qt5 开发库和编译工具链apt-get install -y qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools build-essential libgl1-mesa-dev

下载量约 200MB，务必使用国内源。在多核配置下约需十几分钟。安装完成后，确认 qmake 可用：

qmake --version#输出：QMake version 3.1Using Qt version 5.15.2 in /usr/lib/aarch64-linux-gnu

3.2 安装 Python 编译工具

pip3.10 config set global.index-url https://mirrors.aliyun.com/pypi/simple/pip3.10 install --upgrade pip setuptools wheel sip PyQt-builder输出：Successfully installed PyQt-builder-1.19.1 packaging-26.2 pip-26.1.2 setuptools-82.0.1 sip-6.15.3 tomli-2.4.1 wheel-0.47.0

3.3 下载 PyQt5 源码

cd /tmpwget https://files.pythonhosted.org/packages/5c/46/b4b6eae1e24d9432905ef1d4e7c28b6610e28252527cdc38f2a75997d8b5/PyQt5-5.15.9.tar.gztar -xzf PyQt5-5.15.9.tar.gzcd PyQt5-5.15.9

提示：不要使用 pip download --no-binary PyQt5，它会在 "Preparing metadata" 阶段卡死——因为隔离环境找不到 qmake。直接用 wget 下载源码是最可靠的方式。

3.4 用 sip-build 编译

sip-build --confirm-license --qmake=/usr/bin/qmake --build-dir /tmp/pyqt5_build

提示：新版 SIP（v6+）没有独立的 sip 命令。如果使用 python configure.py --sip=... 会报错 is not an executable。必须使用 sip-build。

编译过程输出：

Querying qmake about your Qt installation...This is the GPL version of PyQt 5.15.9 for Python 3.10.20 on linux.Checking to see if the QtCore bindings can be built...Checking to see if the QtNetwork bindings can be built......These bindings will be built: QtCore, QtNetwork, QtGui, QtWidgets, QtDBus,    QtOpenGL, QtPrintSupport, QtSql, QtTest, QtXml, Qt,    _QOpenGLFunctions_2_0, _QOpenGLFunctions_2_1, _QOpenGLFunctions_4_1_Core,    pylupdate, pyrcc.Generating the QtCore bindings...Generating the .pro files...Generating the Makefiles...Compiling the project...The project has been built.

deprecated 警告可忽略，不影响编译结果。编译时间约好几个小时，我测试多次都是在晚上完成，睡着了，不知多久（取决于 WSL 2 资源配置）。期间可另开 CMD 执行 docker ps 确认容器仍在运行。

3.5 安装编译产物

cd /tmp/pyqt5_buildmakeinstall

PyQt5 被安装到 /usr/local/lib/python3.10/site-packages/PyQt5/。

3.6 安装 PyQt5-sip

PyQt5-sip 是 PyQt5 的运行时依赖：

pip3.10 install PyQt5-sip

pip 自动下载源码、编译、生成 wheel 并安装。输出：

Created wheel for PyQt5-sip: filename=pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whlSuccessfully installed PyQt5-sip-12.18.0

3.7 验证编译结果

python3.10 -c "from PyQt5 import QtWidgets; print('PyQt5 编译安装成功')"

输出：

PyQt5 编译安装成功

四、打包 Qt5 运行时库

编译成功只代表容器内能正常使用，我以为是万事大吉了。但是当我直接把 PyQt5 打包部署到麒麟，不断出现报错，下面记录发现和解决问题的过程。

4.1 问题复现

假设我们只打包 PyQt5 编译产物并部署到麒麟，验证时会遇到以下错误：

第一个错误：

ImportError: /opt/python310/lib/python3.10/site-packages/PyQt5/QtWidgets.abi3.so:undefined symbol: _ZNK9QTextEdit10MarkdownE6QFlagsIN13QTextDocument15MarkdownFeatureEE, version Qt_5

原因：PyQt5 的 .so 文件在编译时链接了 Docker 容器（Debian 11）中的 Qt 5.15.2，但麒麟 V10 的 Qt 版本更低（或根本没有 Qt5），导致符号找不到。

第二个错误（装上 Qt5 库之后）：

ImportError: libmd4c.so.0: cannot open shared object file

原因：Qt5 本身还依赖 libmd4c（Markdown 解析库），麒麟上也没有。

第三个错误（装上 libmd4c 之后）：

ImportError: libicui18n.so.67: cannot open shared object file

原因：Qt5 还依赖 ICU 国际化库。

一个接一个追缺少的 .so 文件会没完没了。需要一次性解决。

4.2 原因分析

执行以下命令确认麒麟是否自带 Qt5：

find /usr -name"libQt5*.so*"2>/dev/null

如果没有输出，说明麒麟 V10 没有预装 Qt5 运行库。PyQt5 的 .so 文件在麒麟上运行时，找不到它链接的任何 Qt5 库。

依赖树发现方法。在 Docker 容器中，用 `ldd` 命令查看 `libQt5Widgets.so` 的全部依赖：

ldd /usr/lib/aarch64-linux-gnu/libQt5Widgets.so.5 |grep"=> /"|awk'{print $3}'|sort-u

输出包含了完整的依赖树：

/lib/aarch64-linux-gnu/libc.so.6        ← glibc 核心，麒麟自带，不打包/lib/aarch64-linux-gnu/libdl.so.2       ← glibc 核心，不打包/lib/aarch64-linux-gnu/libgcc_s.so.1    ← 基础库，不打包/lib/aarch64-linux-gnu/libm.so.6        ← glibc 核心，不打包/lib/aarch64-linux-gnu/libpcre.so.3     ← 基础库，麒麟可能有/lib/aarch64-linux-gnu/libpthread.so.0  ← glibc 核心，不打包/lib/aarch64-linux-gnu/libz.so.1        ← 基础库，麒麟可能有/usr/lib/aarch64-linux-gnu/libGL.so.1/usr/lib/aarch64-linux-gnu/libGLX.so.0/usr/lib/aarch64-linux-gnu/libGLdispatch.so.0/usr/lib/aarch64-linux-gnu/libQt5Core.so.5/usr/lib/aarch64-linux-gnu/libQt5Gui.so.5/usr/lib/aarch64-linux-gnu/libX11.so.6/usr/lib/aarch64-linux-gnu/libXau.so.6/usr/lib/aarch64-linux-gnu/libXdmcp.so.6/usr/lib/aarch64-linux-gnu/libbrotlicommon.so.1/usr/lib/aarch64-linux-gnu/libbrotlidec.so.1/usr/lib/aarch64-linux-gnu/libbsd.so.0/usr/lib/aarch64-linux-gnu/libdouble-conversion.so.3/usr/lib/aarch64-linux-gnu/libfreetype.so.6/usr/lib/aarch64-linux-gnu/libglib-2.0.so.0/usr/lib/aarch64-linux-gnu/libgraphite2.so.3/usr/lib/aarch64-linux-gnu/libharfbuzz.so.0/usr/lib/aarch64-linux-gnu/libicudata.so.67    ← 必须打包/usr/lib/aarch64-linux-gnu/libicui18n.so.67    ← 必须打包/usr/lib/aarch64-linux-gnu/libicuuc.so.67      ← 必须打包/usr/lib/aarch64-linux-gnu/libmd.so.0/usr/lib/aarch64-linux-gnu/libmd4c.so.0        ← 必须打包/usr/lib/aarch64-linux-gnu/libpcre2-16.so.0/usr/lib/aarch64-linux-gnu/libpng16.so.16/usr/lib/aarch64-linux-gnu/libstdc++.so.6/usr/lib/aarch64-linux-gnu/libxcb.so.1/usr/lib/aarch64-linux-gnu/libzstd.so.1

4.4 打包原则

库类型	是否打包	原因
glibc 核心（libc、libm、libpthread、libdl）	❌ 不打包	麒麟自带，版本兼容，覆盖会导致系统崩溃
基础系统库（libgcc_s、libpcre、libz）	❌ 不打包	麒麟自带
Qt5 核心库（libQt5*）	✅ 打包	麒麟可能没有
Qt5 间接依赖（libicu*、libmd4c、libfreetype 等）	✅ 打包	麒麟大概率没有或版本不匹配

4.5 完整打包命令

下面是完整的打包命令

cd /tar -czf /output/Qt5_full_runtime_arm64.tar.gz \  usr/lib/aarch64-linux-gnu/libQt5*.so* \  usr/lib/aarch64-linux-gnu/qt5/ \  usr/lib/aarch64-linux-gnu/libicu*.so* \  usr/lib/aarch64-linux-gnu/libmd4c.so* \  usr/lib/aarch64-linux-gnu/libdouble-conversion* \  usr/lib/aarch64-linux-gnu/libpcre2* \  usr/lib/aarch64-linux-gnu/libbrotli* \  usr/lib/aarch64-linux-gnu/libgraphite2* \  usr/lib/aarch64-linux-gnu/libharfbuzz* \  usr/lib/aarch64-linux-gnu/libfreetype* \  usr/lib/aarch64-linux-gnu/libpng16* \  usr/lib/aarch64-linux-gnu/libglib-2.0* \  usr/lib/aarch64-linux-gnu/libzstd* \  usr/lib/aarch64-linux-gnu/libGL*.so* \  usr/lib/aarch64-linux-gnu/libX11* \  usr/lib/aarch64-linux-gnu/libxcb* \  usr/lib/aarch64-linux-gnu/libXau* \  usr/lib/aarch64-linux-gnu/libXdmcp* \  usr/lib/aarch64-linux-gnu/libbsd* \  usr/lib/aarch64-linux-gnu/libmd.so* \  usr/lib/aarch64-linux-gnu/libstdc++.so* \  /lib/aarch64-linux-gnu/libpcre.so* \  /lib/aarch64-linux-gnu/libz.so*ls -lh /output/Qt5_full_runtime_arm64.tar.gz

输出：

-rw-r--r-- 1 root root 31M Jun 25 03:47 /output/Qt5_full_runtime_arm64.tar.gz

五、提取 PyQt5 编译产物

5.1 PyQt5-sip：使用 wheel

PyQt5-sip 在 pip 安装时已自动生成 wheel，直接提取：

# 查找 wheel 文件find /root/.cache -name "pyqt5_sip*.whl"# 复制到 outputcp /root/.cache/pip/wheels/71/8b/02/da35b19cc796c4dbddef0d58e1c98f737b2418cc5a0f2f82e7/pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whl /output/ls -lh /output/pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whl

输出：

-rw-r--r-- 1 root root 322K Jun 24 22:58 /output/pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whl

5.2 PyQt5 核心：使用 tar.gz

PyQt5 无法打包为 wheel，原因如下：

sip-build 编译 PyQt5 时，产物的安装方式不是标准的 Python wheel 流程。它会生成 .so 文件和一个 pyqt5-5.15.9.dist-info 目录，但缺少 wheel 打包必需的 WHEEL 和 RECORD 文件。即使尝试 pip3.10 wheel，也会在 Preparing metadata 阶段反复触发编译最终卡住。因此对于 sip-build 编译的 PyQt5，tar.gz 是最可靠的打包方式。

cd /usr/local/lib/python3.10/site-packagestar -czf /output/PyQt5-5.15.9-cp310-cp310-linux_aarch64.tar.gz PyQt5/ pyqt5-5.15.9.dist-info/ls -lh /output/PyQt5-5.15.9-cp310-cp310-linux_aarch64.tar.gz

输出：

-rw-r--r-- 1 root root 5.0M Jun 25 02:10 /output/PyQt5-5.15.9-cp310-cp310-linux_aarch64.tar.gz

六、麒麟上部署

6.1 部署前检查

确认麒麟没有自带 Qt5 库：

find /usr -name"libQt5*.so*"2>/dev/null

如果无输出，说明系统没有 Qt5，可以直接部署到系统目录

6.2 拷贝文件清单

从 D:\pytq-test 拷贝以下 3 个文件到麒麟：（关注公众号，回复：pyqt5可以获取）

文件	大小	用途
`Qt5_full_runtime_arm64.tar.gz`	31MB	Qt5 运行时库及全部间接依赖
`PyQt5-5.15.9-cp310-cp310-linux_aarch64.tar.gz`	5.0MB	PyQt5 核心编译产物
`pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whl`	322KB	PyQt5-sip 运行时

6.3 部署步骤

# 1. 部署 Qt5 运行时库（麒麟无自带 Qt5，直接放系统目录安全）sudo tar -xzf Qt5_full_runtime_arm64.tar.gz -C /sudo ldconfig# 2. 部署 PyQt5 编译产物sudo tar -xzf PyQt5-5.15.9-cp310-cp310-linux_aarch64.tar.gz -C /opt/python310/lib/python3.10/site-packages/# 3. 安装 PyQt5-sip/opt/python310/bin/pip3.10 install --no-index --find-links=. pyqt5_sip-12.18.0-cp310-cp310-linux_aarch64.whl# 4. 验证/opt/python310/bin/python3.10 -c "from PyQt5 import QtWidgets; print('PyQt5 OK')"

期望输出：

PyQt5 OK

按照上面的步骤，就完成了PyQT5的编译安装。

文章总结

本文解决了纯 Python 依赖的打包问题。但项目中如果使用了 PyQt5 这类 C++ 扩展呢？PyQt5 官方从未发布 aarch64的预编译 wheel，必须从源码编译。而且编译后的 .so 文件依赖 Qt5 运行时库，麒麟 V10 没有自带 Qt5，部署时还会遇到 undefined symbol 和 libmd4c.so.0: cannot open 等错误。

（关注公众号，回复：“pyqt5”可以获取打包好的依赖包，写文章不容易，点个赞再走！）

本文来自网友投稿或网络内容，如有侵犯您的权益请联系我们删除，联系邮箱：wyl860211@qq.com 。

第二是采用APT 版本的局限性。Debian 11 的 APT 源中有 `python3-pyqt5` 预编译包：

3.1 安装 Qt5 编译依赖

下载量约 200MB，务必使用国内源。在多核配置下约需十几分钟。安装完成后，确认 qmake 可用：

3.2 安装 Python 编译工具

3.6 安装 PyQt5-sip

四、打包 Qt5 运行时库

4.1 问题复现

4.2 原因分析

依赖树发现方法。在 Docker 容器中，用 `ldd` 命令查看 `libQt5Widgets.so` 的全部依赖：

输出包含了完整的依赖树：

4.4 打包原则

4.5 完整打包命令

五、提取 PyQt5 编译产物

5.1 PyQt5-sip：使用 wheel

六、麒麟上部署

6.1 部署前检查

6.3 部署步骤

文章总结

借助Docker离线搭建银河麒麟Python 环境(三):Docker 编译 PyQt5 + PyQt5 运行时库打包

本系列包含四篇文章：

最新文章

热门文章

随机文章

借助Docker离线搭建银河麒麟Python 环境(三):Docker 编译 PyQt5 + PyQt5 运行时库打包

本系列包含四篇文章：

第二是采用APT 版本的局限性。Debian 11 的 APT 源中有 python3-pyqt5 预编译包：

3.1 安装 Qt5 编译依赖

下载量约 200MB，务必使用国内源。在多核配置下约需十几分钟。安装完成后，确认 qmake 可用：

3.2 安装 Python 编译工具

3.6 安装 PyQt5-sip

四、打包 Qt5 运行时库

4.1 问题复现

4.2 原因分析

依赖树发现方法。在 Docker 容器中，用 ldd 命令查看 libQt5Widgets.so 的全部依赖：

输出包含了完整的依赖树：

4.4 打包原则

4.5 完整打包命令

五、提取 PyQt5 编译产物

5.1 PyQt5-sip：使用 wheel

六、麒麟上部署

6.1 部署前检查

6.3 部署步骤

文章总结

纯 Python 撸出 React 级 Web 应用?HTML/CSS/JS 连备胎都当不成了,太狠了

基于Python的商品评论数据采集可视化分析系统F0010

最新文章

热门文章

随机文章

第二是采用APT 版本的局限性。Debian 11 的 APT 源中有 `python3-pyqt5` 预编译包：

依赖树发现方法。在 Docker 容器中，用 `ldd` 命令查看 `libQt5Widgets.so` 的全部依赖：