上周(2022年4月21日),Ubuntu 发布了最新的 LTS 版本—— 22.04 LTS (Jammy Jellyfish)。然而该版本默认的 Python 3 版本为 Python 3.10,高于许多开发者正在使用的 3.9、3.8 甚至更早版本。特撰写本教程,记录从源代码编译安装 Python 3.9 的全过程,3.8 或其他版本同样适用。
从源代码编译安装 Python 步骤并不复杂,但很多细节都隐藏着 “坑”,在后期使用开发时可能造成很大的麻烦。建议读者仔细阅读博客原文全文后再开始逐步操作。
在正式开始之前,建议首先检查系统软件是否均为最新,并更新到最新版本。
打开一个终端,输入以下命令:
# 刷新软件包目录
sudo apt update
# 列出当前可用的更新
sudo apt list --upgradable
# 如上一步提示有可以更新的项目,则执行更新
sudo apt upgrade
打开一个终端,使用 apt 安装 GCC 编译器:
# 安装 GCC 编译器
sudo apt install gcc
# 检查安装是否成功
gcc -v
# 若显示出 GCC 版本则成功
# 刷新软件包目录
sudo apt update
# 安装依赖
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libbz2-dev liblzma-dev sqlite3 libsqlite3-dev tk-dev uuid-dev libgdbm-compat-dev
注意,Python 的部分功能依赖于对应的库(如 OpenSSL、SQLite3、LZMA 等),如果在编译时未能找到这些库,仍然可能完成编译。此时的 Python 解释器看似可以工作,但在需要使用特定功能时就会出问题。例如 OpenSSL 出现问题会导致无法正常使用 pip。故建议按本节提示安装所有可选依赖项,并在下一节编译时仔细检查有无报错信息。
在 Python 官网下载界面下载 Python 3.9 的源代码,此处使用目前最新的 3.9.12。
亦可通过 wget
下载:
# 下载 Python 3.9.12
sudo wget https://www.python.org/ftp/python/3.9.12/Python-3.9.12.tar.xz
# 下载其他版本只需替换版本号数字
解压并进入该目录,后续的所有命令均在该目录中执行:
# 解压
tar -xf Python-3.9.12.tar.xz
# 进入该目录
cd Python-3.9.12/
# 检查依赖与配置编译
sudo ./configure --enable-optimizations --with-lto --enable-shared
此处使用了三个可选配置项,含义如下:
--enable-optimizations
:用 PROFILE_TASK 启用以配置文件主导的优化(PGO)--with-lto
:在编译过程中启用链接时间优化(LTO)--enable-shared
:启用共享 Python 库 libpython
的编译更多可用配置项的信息,请参阅 Python 官方文档。
经过一系列检查无误之后,会自动生成 Makefile,即可进行下一步的编译了。
完成配置,生成 Makefile 后,就可以开始编译了。编译耗时较长,可以使用 -j
选项指定参与编译的 CPU 核心数,例如此机器为 6 核 CPU:
# 编译,-j 后面的数字为参与编译的CPU核心数,根据个人机器配置调整
sudo make -j 6
编译结束后,注意仔细查看一下输出,检查可能存在的错误:
# 一种可能出现的问题:
$ sudo make
# ......省略部分输出......
Python build finished successfully!
The necessary bits to build these optional modules were not found:
_dbm _tkinter _uuid
To find the necessary bits, look in setup.py in detect_modules() for the module's name.
如果出现类似如上的警告,说明编译时有部分软件包不可用,导致编译出的 Python 有部分可选模块不可用。检查上一节中提到的依赖是否都已安装,或求助于网络搜索引擎,安装对应软件包后再次编译即可。
# 安装二进制文件
sudo make altinstall
在 Makefile 中有如下提示:
If you have a previous version of Python installed that you don’t want to overwrite, you can use “make altinstall” instead of “make install”.
故应使用 altinstall
而不是 install
。二者的一个重要区别在于,后者会创建符号链接,将 python3
等命令链接到正在安装的新版本 Python 3 上,这可能会破坏系统。更多信息请参阅当前目录下的 README.rst
文件。
由于编译配置中有 --enable-shared
的选项,故此时直接使用命令 python3.9
会提示无法找到 libpython3.9.so.1.0
的错误。只需找到该 so
文件,复制(或创建符号链接)到 /usr/lib/
目录下即可:
# 找到 libpython 的位置
$ whereis libpython3.9.so.1.0
libpython3.9.so.1: /usr/local/lib/libpython3.9.so.1.0
# 在 /usr/lib/ 下创建 libpython 的符号链接
$ sudo ln -s /usr/local/lib/libpython3.9.so.1.0 /usr/lib/
完成安装后,Python 3.9 会与系统原有的 Python 3.10 共存。由于 Ubuntu 系统、安装的其他软件等很可能会依赖于系统原有的 3.10,所以不要移除原有 Python 环境,也不要对 python3
等命令进行修改。
直接在命令行使用 python3.9
命令即可调用新安装的解释器:
# 在命令行使用 Python 交互式解释器
$ python3.9
Python 3.9.12 (main, Apr 22 2022, 18:58:57)
[GCC 11.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>
# 查看该命令所在位置
$ which python3.9
/usr/local/bin/python3.9
类似的,使用 Python 3.9 的 pip
的命令为 pip3.9
# 查看 pip3.9 版本
$ pip3.9 -V
pip 22.0.4 from /usr/local/lib/python3.9/site-packages/pip (python 3.9)
在 PyCharm 中简单设置后,就可以使用新安装的解释器了。
首先打开 PyCharm 设置,找到 “Python 解释器” 一项,点击下拉菜单——全部显示:
点击左上角的 +
,添加新的解释器(此处在另一台机器上截图,故列表中出现一些原有的解释器环境,读者忽略即可):
选择添加 “系统解释器”,点击后面的 ...
以浏览选择解释器路径:
编译安装,解释器可执行文件默认路径为 /usr/local/bin/python3.9
,或者可以返回上一节检查命令 python3.9
的位置。在此处将完整路径粘贴进编辑框即可:
点击确定,即可正常使用新安装的解释器了: