Ubuntu 源码编译安装 Python 3.10 完整步骤

在 Ubuntu 系统中通过源码编译安装 Python 3.10，是获取特定次版本、启用特定编译优化（如 PGO 与 LTO）以及与系统自带 Python 保持完全隔离的标准方式。本文将按实际操作次序，完整演示从安装构建依赖、下载官方源码包、配置性能优化参数，到多核编译以及使用 make altinstall 独立安装的全过程，并提供常用扩展验证与故障排查方案。

图 1：Python 3.10 源码构建各阶段核心命令与流转逻辑

一、前期准备：安装编译工具链与模块依赖库

源码编译 Python 的第一步并非直接下载源码，而是提前补齐构建工具（C/C++ 编译器、连接器）以及各类动态链接库头文件。Python 解释器的核心模块并非全部纯用 Python 实现，例如用于网络加密的 _ssl、用于调用动态链接库的 _ctypes、用于读取配置文件的 _sqlite3 以及用于交互式补全的 readline 均依赖宿主系统的开发头文件（开发包通常以 -dev 结尾）。

如果在执行 ./configure 或编译前缺失这些头文件，编译过程虽然通常能够完成，但在最后会输出“可选模块构建失败”的静默提示，导致最终生成的 Python 无法正常运行 pip 或无法建立 HTTPS 请求。

# 1. 更新本地软件包索引
sudo apt update

# 2. 安装编译核心工具与全部必要依赖头文件
sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev \
libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev wget \
libbz2-dev liblzma-dev tk-dev

图 2：底层依赖缺失会导致相应模块在编译期被忽略

二、下载并解压 Python 3.10 官方源码

建议将源码包下载至 /usr/src 或当前用户的临时工作目录中。本文以 Python 3.10 的较成熟微版本 Python-3.10.14 为例进行演示。读者也可访问 Python 官方站点确认最新发布的修订补丁版本。

# 1. 切换至临时工作目录
cd /usr/src

# 2. 从 Python 官方 FTP 服务器下载源码包
sudo wget https://www.python.org/ftp/python/3.10.14/Python-3.10.14.tgz

# 3. 解压源码归档包
sudo tar -xf Python-3.10.14.tgz

# 4. 进入解压后的源码目录
cd Python-3.10.14

解压后，目录内包含 configure 配置脚本、Makefile.pre.in 模板以及 C 源码与 Python 核心标准库目录。

三、运行配置脚本并设置构建优化选项

在编译前，需要执行 ./configure 检查系统硬件架构、检测已安装的开发库，并生成适配当前机器的 Makefile。为了获得更优的解释器运行性能，推荐添加 --enable-optimizations 参数。

# 执行系统检测与环境配置
./configure --enable-optimizations --with-lto

四、并行编译与安全安装：make 与 make altinstall

配置脚本成功执行并生成 Makefile 后，即可调用编译器进行构建。由于 PGO 测试和多文件编译计算量较大，应充分利用多核 CPU 的计算资源。

# 1. 利用全部 CPU 物理/逻辑核心并发编译
make -j$(nproc)

编译执行完毕后，执行安装步骤。此处务必注意：必须使用 make altinstall，绝不可使用 make install。

# 2. 隔离安装至系统目录
sudo make altinstall

图 3：为什么在 Linux 生产环境中必须坚持使用 make altinstall

五、验证安装结果与关键模块可用性

安装完成后，新版本可执行文件默认放置在 /usr/local/bin/。通过以下四个维度的命令逐项核实解释器运行状态。

图 4：安装后的四大基础健康检查项

1. 检查解释器版本与定位路径

# 检查版本号
python3.10 -V
# 示例输出：Python 3.10.14

# 确认安装二进制绝对路径
which python3.10
# 示例输出：/usr/local/bin/python3.10

# 确认系统原生 Python 保持不变
python3 -V
# 示例输出（以 Ubuntu 22.04 为例）：Python 3.10.12 或 Ubuntu 20.04 的 Python 3.8.10

2. 验证配套包管理工具 pip

# 检查 pip3.10 是否正确映射
pip3.10 -V
# 示例输出：pip 23.0.1 from /usr/local/lib/python3.10/site-packages/pip (python 3.10)

3. 验证 SSL 与 CTypes 关键核心扩展

运行一行代码测试 ssl 模块与 ctypes 动态库是否能够正常被 Python 内核加载：

python3.10 -c "import ssl, ctypes; print('OpenSSL 版本:', ssl.OPENSSL_VERSION); print('ctypes 支持:', ctypes.__name__)"
# 示例输出：
# OpenSSL 版本: OpenSSL 3.0.2 15 Mar 2022
# ctypes 支持: ctypes

若能够正常打印 OpenSSL 版本信息且无报错，表明后续执行 pip3.10 install <package> 时能够顺利建立 HTTPS 连接下载第三方包。

六、创建专属虚拟环境

源码安装的 Python 属于系统层级的运行时环境。在实际项目开发中，不建议直接使用 sudo pip3.10 install 向 /usr/local/lib/python3.10/site-packages 全局安装包，而应使用 Python 3.10 自带的 venv 模块为每个项目创建独立虚拟环境：

# 1. 创建项目目录并进入
mkdir -p ~/demo-python310 && cd ~/demo-python310

# 2. 基于 Python 3.10 创建轻量沙箱环境
python3.10 -m venv .venv

# 3. 激活虚拟环境
source .venv/bin/activate

# 4. 此时终端环境中的 python 与 pip 将自动指向该虚拟环境
(venv) $ which python
# 示例输出：/home/ubuntu/demo-python310/.venv/bin/python

(venv) $ pip install requests

七、常见问题排查与注意事项

遵循上述规范：先备齐依赖、开启合理编译选项、严格执行 make altinstall 保持路径隔离，便可在任意版本的 Ubuntu 环境中稳健、高效地运行特定构建版本的 Python 3.10。