统信UOS专业版1070arm64装Python3.8.0这件事我在本地折腾了一整天中间踩了不少坑也把整套流程理顺了。这篇文章就是把当时实际操作的过程完整复盘一遍包括为什么非要源码编译、怎么处理依赖、configure参数怎么选、编完以后怎么避免把系统搞坏以及几个反复出现的报错怎么排查。手上正好有arm64设备飞腾、麒麟或者鲲鹏主板的机器又需要在上面用Python3.8做开发的可以直接照着做。先说结论统信UOS V20专业版1070基于Debian 10体系系统自带的Python是3.7系列并不自带Python3.8。如果项目依赖锁定了3.8。x最稳妥的办法不是折腾软件源而是下载官方源码在本地编译安装。整个流程对硬件性能有一些要求建议内存4GB以上、磁盘空余空间至少2GB。下面进入正题。1. 为什么在UOS arm64上装Python3.8这么特殊1.1 统信UOS专业版1070的系统基础统信UOS V20专业版1070是面向政企办公和行业应用的操作系统底层基于Debian 10Buster但并不是原生Debian而是做了大量国产化适配的发行版本。换句话说它继承了Debian的包管理机制可以用apt安装软件但软件源、内核、图形桌面层都做了深度调整。正因为是基于Debian 10所以软件仓库里的Python默认版本是3.7系列。python3指向/usr/bin/python3而/usr/bin/python3的实际版本是3.7.3。这是整个系统的基础组件很多桌面工具、系统管理脚本、软件中心都依赖这个Python解释器。这就引出了第一个关键原则不能覆盖系统自带的Python3。如果你贸然把/usr/bin/python3指向了3.8版本后果可能是桌面组件起不来、控制中心异常、软件包管理器崩溃——这类问题在国产化操作系统里非常常见。正确做法是让Python3.8以独立身份安装与系统Python3.7共存。1.2 arm64和amd64的区别在哪里标题里特意提到arm64说明这不是普通的x86环境。arm64也叫aarch64是ARM公司推出的64位指令集架构与Intel/AMD主导的amd64x86-64在指令集上是完全不同的两套体系。这意味着x86平台上编译出来的二进制包不能直接在arm64上运行pip安装纯Python包没有问题因为纯Python包是跨平台的源码但包含C扩展的包必须要有aarch64版本的wheel包或者本机编译最典型的例子是numpy、pandas、Pillow、lxml这些常用科学计算库虽然PyPI上已经提供了arm64的wheel但有些偏门库没有预编译包只能靠本机下载源码后编译在UOS这样的国产化系统上还多一层复杂性部分ARM平台是飞腾、鲲鹏、麒麟等国产芯片它们的处理器微架构和编译优化参数都不一样。虽然都是aarch64指令集但用同一份源码编译出来的性能表现会有差异个别特殊指令的启用情况也不同。1.3 为什么不能直接双击安装包或者用商店安装很多刚接触统信UOS的人会习惯性地以为可以像Windows一样下载一个安装包然后下一步到底。但Linux系统装Python不是这么玩的。统信应用商店里并没有提供Python3.8安装包就算有也不一定针对arm64进行了适配。从软件安装方式上看Linux下安装Python大致有三条路apt从官方源安装简单但UOS官方源大概率没有python3.8这个包下载预编译二进制包对arm64支持不友好官方并不提供Linux arm64的独立二进制包源码编译安装最可靠也是本次采用的方式源码编译是解决“官方源里没有、又没有现成二进制包”这种情况的标准方案。这也是为什么网上几乎所有关于在国产系统安装指定Python版本的教程最后都指向了源码编译这条路。2. 安装前的准备工作与方案取舍2.1 版本选型为什么是3.8.0而不是别的版本项目标题指定了Python3.8.0这是2019年10月发布的版本。实际生产里如果对版本号没有严格锁定我更建议安装同系列的补丁版本比如3.8.20或3.8.18因为补丁版本修复了很多安全和兼容性问题。不过既然项目锁定了3.8.0就按3.8.0来部署流程是通用的。你只要把下载链接里的版本号替换掉其他步骤完全一致。有一点要注意Python 3.8.x各小版本之间的源码在依赖上有细微差别特别是libffi和OpenSSL版本检测那一块所以如果你换版本编译遇到报错优先看看依赖库版本是否过旧。2.2 方案对比apt安装vs源码编译vs容器方案在UOS上装Python3.8还有一个思路用Docker。如果目标机器上已经跑着Docker那么拉一个python:3.8的镜像是最省事的因为镜像内部已经有编译好的Python环境。但桌面系统的使用场景和服务器不一样很多应用需要直接调用宿主机上的Python解释器Docker方案对桌面场景不太友好而且有些政企内网环境并没有配置Docker镜像源。另外用虚拟化方案比如qemu模拟arm64也是一个思路。如果你手上只有x86电脑但是要验证arm64上能不能跑通Python3.8可以先用qemu-system-aarch64启动一个UOS arm64虚拟机做测试。这个思路在开发阶段很好用性能损耗比较大但优点是可以避免频繁重装系统。qemu的安装和使用方法这里不展开只说一点UOS arm64的镜像文件可以直接作为虚拟机的磁盘镜像加载加上-machine virt -cpu cortex-a57这样的参数就能跑起来。测试完毕确认没问题再到实机上操作这是最稳妥的工作流。2.3 下载Python3.8.0源码与校验第一步是去Python官网下载源码包。建议使用wget或者curl在命令行直接下载避免图形界面下载文件后路径找不到的问题。Python官方提供了GPG签名文件可以下载后校验一下完整性尤其是在政企内网环境这一步不能省。cd ~/Downloads wget https://www.python.org/ftp/python/3.8.0/Python-3.8.0.tgz wget https://www.python.org/ftp/python/3.8.0/Python-3.8.0.tgz.asc如果官网下载速度太慢可以使用国内镜像源下载比如华为云镜像、淘宝npm镜像等。这里我用的是华为云镜像站wget https://mirrors.huaweicloud.com/python/3.8.0/Python-3.8.0.tgz下载完成后解压tar xzf Python-3.8.0.tgz cd Python-3.8.0注意不要用dpkg或alien去转换Python的RPM包来安装统信UOS虽然能兼容部分rpm包转deb但Python这种多文件分派到不同目录的软件转换安装后链接经常会出现问题。2.4 安装编译工具链和依赖库这一步是整个流程里最容易出问题的环节。Python源码编译需要gcc、g、make等基础工具同时还依赖多个系统开发库。缺少任何一个编译过程都可能报错或者编译出来的Python功能不全。在UOS专业版1070上你需要安装的依赖大致如下sudo apt update sudo apt install -y \ gcc \ g \ make \ zlib1g-dev \ libssl-dev \ libffi-dev \ libsqlite3-dev \ libreadline-dev \ libbz2-dev \ libncurses5-dev \ libncursesw5-dev \ tk-dev \ liblzma-dev \ uuid-dev \ libdb-dev \ libgdbm-dev逐个解释一下为什么要装这些gcc/g/makeC语言/ C编译器Python解释器源码主要用C写成编译过程必须的。zlib1g-devPython的zipimport模块以及ensurepip安装pip都依赖zlib缺了它pip直接装不了。libssl-dev提供OpenSSL开发库编译Python时需要用它的头文件启用_ssl模块。如果缺这个模块后面pip安装任何需要HTTPS的包都会失败。libffi-dev外部函数接口库CFFIctypes模块依赖它。在arm64平台尤其重要因为很多科学计算库会调用CTypes特别是新版Python的_ctypes模块。libsqlite3-devsqlite3模块。可能很多人觉得用不到但Django项目的开发模式对sqlite有强依赖而且新版pip也依赖sqlite。libreadline-dev交互模式下命令行编辑功能。没有它Python解释器里按方向键会出现奇怪的转义字符。liblzma-devPython标准库里的lzma模块依赖主要是压缩文件处理。提示在统信UOS上apt源的地址可能指向了官方源或者内网镜像源。如果执行apt update时提示找不到某些包先检查/etc/apt/sources.list和/etc/apt/sources.list.d/下的源配置确保源URL是正确的。3. 源码编译完整实操过程3.1 configure参数的选择与含义进入到解压后的源码目录第一步运行configure脚本。这是整个编译过程的核心参数决定了编译出来的Python安装到哪里、优化程度如何、哪些功能会被启用。我推荐使用的configure命令是./configure \ --prefix/usr/local/python3.8 \ --enable-optimizations \ --with-ensurepipinstall \ --with-ssl-default-suitesopenssl逐个参数说明参数作用--prefix/usr/local/python3.8指定安装路径。将Python3.8独立安装在/usr/local/python3.8目录下与系统默认Python完全隔离。后面不用了直接删掉这个目录就能干净卸载--enable-optimizations启用编译器优化会做Profile-Guided OptimizationPGO编译出的Python解释器运行速度更快。代价是编译时间翻倍arm64设备上可能要等很久--with-ensurepipinstall安装时自动安装pip和setuptools。如果不加这个参数装完Python后还得手动去装pip容易出问题--with-ssl-default-suitesopenssl指定使用系统OpenSSL配置的TLS套件与系统集成更紧密还有两个参数可以根据实际情况调整--enable-shared编译成共享库libpython3.8.so。如果你后续要用mod_wsgi或者某些嵌入式场景需要加这个参数。普通使用不建议加因为加了之后如果不配置LD_LIBRARY_PATHPython启动时会找不到libpython3.8.so反而多出一条麻烦事。--with-system-ffi使用系统的libffi。有些系统的libffi版本过旧可能导致ctypes模块编译失败。UOS 1070使用的libffi版本不算旧如果编译报错再考虑关闭这个参数。configure脚本运行结束后会生成一个Makefile。同时输出一个摘要信息列出检测到的模块可以在这里检查一下_ssl、_ctypes、sqlite3等关键模块是否为“enabled”。3.2 编译与安装make与make installconfigure通过后开始编译make -j4-j4是指用4个并行任务编译。这个参数要根据CPU核心数调整。arm64设备常见的处理器核心数是4核或8核。并行编译能大幅缩短时间但内存紧张的设备比如只有2GB内存的机器建议不要设置过大的并行数否则会因内存不足卡死。如果不需要PGO优化可以跳过了--enable-optimizations编译速度会快很多。但照我实测同一个Python3.8.0在飞腾FT-20004核平台开启优化后编译大约要50分钟不开的话大概15分钟就能完成。编译完成后执行安装sudo make install这一步会把Python安装到/usr/local/python3.8目录下并且自动创建pip和setuptools。安装完成后验证一下/usr/local/python3.8/bin/python3.8 -V正常会输出Python 3.8.0。3.3 配置环境变量与软链接R安装完成只是第一步接下来要把Python3.8接入到用户环境中。我不建议把/usr/bin/python3替换成3.8版本因为系统很多工具依赖自带Python尤其是桌面环境下替换了可能导致日志收集组件、软件管理模块崩溃。建议用软链接加PATH的方式sudo ln -s /usr/local/python3.8/bin/python3.8 /usr/local/bin/python3.8 sudo ln -s /usr/local/python3.8/bin/pip3.8 /usr/local/bin/pip3.8把/usr/local/bin加入PATH一般默认已经在PATH里了这样用户执行python3.8就能直接启动新装的Python。执行一下验证which python3.8 python3.8 -V这里要说一下为什么是软链接到/usr/local/bin而不是直接设置PATH环境变量。/usr/local/bin几乎在所有的现代Linux发行版里默认都在PATH中而/usr/local/python3.8/bin则不在。通过软链接方式可以避免修改/etc/profile从而避免对环境变量的全局修改。还可以在~/.bashrc里追加别名设置echo alias python/usr/local/python3.8/bin/python3.8 ~/.bashrc echo alias pip/usr/local/python3.8/bin/pip3.8 ~/.bashrc source ~/.bashrc提示这个别名只对当前用户生效。如果每次执行python都要加上3.8这个后缀会让你觉得不习惯可以用别名把python指向3.8。但要注意系统内已有的.bashrc别名可能会冲突先看下原有配置。3.4 创建虚拟环境与pip配置Python3.8安装完成后建议为项目创建一个虚拟环境避免污染全局环境。arm64平台上同样可以使用venv模块cd ~/project /usr/local/python3.8/bin/python3.8 -m venv myenv source myenv/bin/activate python -V虚拟环境创建之后可以顺手把pip升级到最新版本并配置国内镜像源pip install --upgrade pip pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/pip换源这一步在很多时候能救命。政企内网访问PyPI可能非常慢甚至超时配置国内镜像后下载速度提升非常明显。如果你使用清华源或阿里源注意镜像站的证书是否正常如果证书有问题还需要执行pip config set global.trusted-host mirrors.aliyun.com来信任该源。4. 常见问题与排查技巧实录4.1 编译后pip无法使用HTTPS提款No module named _ssl这是UOS上编译Python最常见的报错之一。现象是pip安装包时报错ModuleNotFoundError: No module named _ssl或者Could not fetch URL https://pypi.org/...。原因通常是configure阶段没有检测到OpenSSL开发库或者编译时OpenSSL版本过低。Python3.8.0需要OpenSSL 1.0.2或1.1.x版本。检查方法openssl version如果版本正常说明问题出在configure阶段没找到头文件。检查是否安装了libssl-devdpkg -l | grep libssl-dev如果没有安装执行安装后再重新编译。我已经把libssl-dev列入了依赖清单如果你在安装依赖时漏掉了这一步编译出的Python就会出现这种功能缺失问题。解决之后需要重新编译make clean ./configure --prefix/usr/local/python3.8 --enable-optimizations --with-ensurepipinstall make -j4 sudo make install4.2 缺少_ctypes模块导致第三方库安装失败另一个高频报错是ModuleNotFoundError: No module named _ctypes。这个模块在Python3.8中扮演的角色是提供C语言接口调用能力。很多第三方库在安装时会检测_ctypes模块一旦缺失直接拒绝安装。原因是缺少libffi开发库。刚才依赖清单里有libffi-dev如果你跳过或者apt源里没有这个包就会遇到这个报错。解决办法sudo apt install libffi-dev然后重新编译一遍。注意make install并不会重新生成_modules你需要先make clean再重新编译。4.3 编译时内存不足导致卡死或直接被killarm64设备很多是嵌入式主板内存可能只有2GB或者4GB。执行make -j4时如果内存不足编译进程会被系统OOM Killer杀掉或者整个系统都卡住无法操作。这种情况建议把并行数降低make -j1虽然编译耗时增加但胜在稳定。另外如果开启了--enable-optimizationsPGO阶段会更吃内存。如果你发现这个阶段反复崩溃建议取消优化参数改成./configure --prefix/usr/local/python3.8 --with-ensurepipinstall性能差距在日常开发中感知不明显稳定性最重要。4.4 软链接冲突覆盖系统Python的风险我在一开始强调过不要动系统自带的Python。但实际操作中还是有人会执行sudo ln -s /usr/local/python3.8/bin/python3.8 /usr/bin/python3这种做法非常危险。统信UOS的桌面端很多组件启动器、控制中心、软件包管理器都调用系统Python3.7。一旦替换轻则软件中心闪退重则整个桌面无法加载。不要用软链接去覆盖/usr/bin/python3用前面提到的/usr/local/bin软链接或别名即可。4.5 Python包安装成功但import报错依赖库兼容问题arm64平台下部分包含C扩展的Python包没有提供aarch64的预编译wheelpip会尝试从源码编译此时编译过程中会调用系统gcc如果缺了该库的系统开发依赖就会报错。比如安装Pillow时报错Could not find zlib、安装lxml时报错need libxml2。解决思路是安装对应的系统依赖库。常用包的依赖对应关系Python包需要安装的系统依赖Pillowlibjpeg-dev, zlib1g-dev, libfreetype6-devlxmllibxml2-dev, libxslt1-devpsycopg2libpq-devmysqlclientdefault-libmysqlclient-devnumpy/pandasgfortran, libopenblas-devmatplotliblibpng-dev, libfreetype6-dev一般来说把这些装上以后绝大多数pip包都能顺利编译。4.6 一个容易忽略的问题locale相关的警告编译后在终端输入python3.8时可能会看到类似Unable to get locale encoding或者Could not find platform independent libraries prefix之类的警告。前者通常是系统locale配置不完整造成的。可以在终端先执行export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8确认问题消失后再把这两行写入~/.bashrc。4.7 安装问题速查表把前几次调试中遇到的问题整理成一张速查表方便按图索骥报错信息原因解决办法No module named _ssl缺libssl-dev或OpenSSL版本过低安装libssl-dev重新编译配置No module named _ctypes缺libffi-dev安装libffi-dev重新编译Ignoring ensurepip failure: pip requires SSL/TLS缺少zlib开发库或SSL库安装zlib1g-dev与libssl-dev后重编make: gcc: Command not foundgcc未安装apt install gccCould not find platform independent libraries编译时configure参数异常make clean后重新configurefatal error: Python.h: No such file or directory编译第三方C扩展时缺Python开发头文件对virtualenv而言是缺少python3-dev头文件重新安装python3.8开发环境zipimport.ZipImportError: cant decompress data缺少zlib安装zlib1g-dev重新编译5. 编译完成后的验证与使用体验5.1 一条命令验证核心模块是否齐全Python编译安装最大的风险是模块缺失。因此装完以后建议做一次快速验证。命令行直接执行/usr/local/python3.8/bin/python3.8 -c import ssl, sqlite3, ctypes, lzma, bz2; print(所有核心模块导入正常)如果不报错说明SSL、SQLite、CTypes、压缩模块都正常工作了。再测试一下pip/usr/local/python3.8/bin/pip3.8 -V验证通过后创建虚拟环境把pandas、requests等常用包安装一下实测pip install requests pandas python -c import requests, pandas; print(requests.__version__, pandas.__version__)5.2 arm64平台使用Python的性能体验在arm64设备上运行Python性能表现与x86设备有一定差异。Python本身是解释型语言纯Python代码的性能差距主要看CPU频率和IPC效率。飞腾、鲲鹏这些芯片的单核性能与同世代x86相比有一定差距纯计算密集的Python任务可能会慢20%-40%。但实际使用中大部分Python项目瓶颈在I/O和网络请求上这部分arm64与amd64的差距并不明显。启用--enable-optimizations以后解释器本身的执行速度确实有提升直观感受是启动速度和简单循环运算变快了。5.3 实用技巧多版本共存时如何快速切换装完Python3.8后系统里会有至少两个Python系统自带3.7和编译安装的3.8。我建议为每个项目创建独立的虚拟环境这样就不需要频繁切换全局版本。如果确实有多个项目分别要求不同版本可以用virtualenv或者conda来管理但conda在arm64平台上的支持需要额外注意Miniforge比Anaconda更适合ARM设备。或者在shell里写一个简单的切换函数alias py3.8source ~/py38venv/bin/activate这样每当需要用到Python3.8的环境时直接输入py3.8就能切进虚拟环境和系统环境互不干扰。5.4 小技巧如何彻底卸载Python3.8如果哪天不需要Python3.8了卸载非常简单。由于全部安装在/usr/local/python3.8目录下直接删除该目录即可sudo rm -rf /usr/local/python3.8 sudo rm /usr/local/bin/python3.8 /usr/local/bin/pip3.8同时清理掉对应的虚拟环境和软链接。系统的Python3.7完全不受影响。6. 一点个人经验总结在统信UOS arm64上编译安装Python3.8.0核心其实就是一个词“隔离”。把自定义版本的Python与系统自带的Python隔离开互不干扰这是Linux多版本共存的关键思路。跑通这一套流程之后后面哪怕要在同样的环境装Python3.9、3.10甚至更老的版本套路完全一样先装依赖库再configure指定prefix接着make和make install最后用软链接或者虚拟环境接入项目。最大的坑从来都不是编译过程而是依赖缺失和默认路径覆盖这两点只要有了意识遇到的概率就大大降低了。还有一点要说一下编译前一定要确认源码包的完整性和来源。有条件的话下载后在本地做一次sha256校验尤其在生产环境下源码被篡改的风险是真实存在的。用官方渠道下载的包相对可靠但安装之后马上执行模块验证这一步不能省。我在这台UOS arm64机器上编译完Python3.8.0之后顺带把一套Django项目跑了起来数据库连接、Celery任务调度、Redis缓存全部正常运行连续运行两周没有出现异常。这个环境现在还在服役稳定性是经过验证的。最后再分享一个小细节编译时如果你用的飞腾CPU可以在configure之前设置环境变量CFLAGS-marcharmv8-acrc这样编译出来的Python会对飞腾处理器做微架构优化判断是否生效可以在编译完成后执行python3.8 -c import sysconfig; print(sysconfig.get_config_var(CFLAGS))查看。不过这个优化对日常开发感知不强追求极致的可以试一下不折腾也没问题。