一、环境准备与依赖安装
-
更新系统与开发工具
sudo yum update -y sudo yum groupinstall "Development Tools" -y sudo yum install -y zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel \ readline-devel tk-devel libffi-devel gdbm-devel db4-devel libpcap-devel xz-devel expat-devel
作用:安装编译 Python 所需的依赖库。若缺少依赖可能导致
_ctypes
、_ssl
等模块编译失败 -
检查 OpenSSL 版本
openssl version
-
若版本低于 1.1.1,需手动升级(Python 3.10 要求 OpenSSL ≥1.1.1):
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz tar -zxvf openssl-1.1.1k.tar.gz && cd openssl-1.1.1k ./config --prefix=/usr/local/openssl shared zlib make && sudo make install # 配置系统使用新版本 echo "/usr/local/openssl/lib" >> /etc/ld.so.conf ldconfig -v ln -s /usr/local/openssl/bin/openssl /usr/bin/openssl
注意:升级后需验证
openssl version
是否显示新版本。
-
二、编译安装 Python 3.10
-
下载源码并解压
wget https://www.python.org/ftp/python/3.10.12/Python-3.10.12.tgz tar -zxvf Python-3.10.12.tgz && cd Python-3.10.12
-
配置编译参数
./configure --prefix=/usr/local/python3.10 \ --enable-optimizations \ --with-openssl=/usr/local/openssl \ --with-ssl-default-suites=openssl
关键参数说明:
-
--with-openssl
:指定自定义 OpenSSL 路径(避免SSL module
缺失)。 -
--enable-optimizations
:优化编译性能,若编译失败可去掉此参数。
-
-
编译与安装
make -j $(nproc) && sudo make altinstall
使用
altinstall
而非install
:避免覆盖系统默认 Python 2.7。 -
验证安装
/usr/local/python3.10/bin/python3.10 --version # 应输出 Python 3.10.x /usr/local/python3.10/bin/python3.10 -c "import ssl; print(ssl.OPENSSL_VERSION)" # 验证 SSL 模块
三、环境配置
-
设置全局软链接
sudo ln -s /usr/local/python3.10/bin/python3.10 /usr/bin/python3 sudo ln -s /usr/local/python3.10/bin/pip3.10 /usr/bin/pip3
-
配置环境变量
echo 'export PATH=$PATH:/usr/local/python3.10/bin' >> /etc/profile source /etc/profile
-
修复 yum 工具冲突 修改
/usr/bin/yum
和/usr/libexec/urlgrabber-ext-down
文件,将#!/usr/bin/python
改为#!/usr/bin/python2
,以解决因 Python 3 导致 yum 失效的问题。
四、常见错误及解决方法
-
zipimport.ZipImportError: can't decompress data; zlib not available
原因:缺少zlib-devel
库。 解决:sudo yum install -y zlib-devel # 重新编译 Python
-
ModuleNotFoundError: No module named '_ctypes'
原因:未安装libffi-devel
。 解决:sudo yum install -y libffi-devel # 重新编译 Python
-
SSL module is not available
或pip 证书验证失败
原因:Python 未正确链接 OpenSSL。 解决:-
确认编译时指定
--with-openssl
路径。 -
若仍报错,手动修改
Modules/Setup
文件,添加以下内容后重新编译:SSL=/usr/local/openssl _ssl _ssl.c -DUSE_SSL -I$(SSL)/include -L$(SSL)/lib -lssl -lcrypto
-
-
动态库缺失(如
libssl.so.1.1
) 解决:ln -s /usr/local/openssl/lib/libssl.so.1.1 /usr/lib64/libssl.so.1.1 ln -s /usr/local/openssl/lib/libcrypto.so.1.1 /usr/lib64/libcrypto.so.1.1 ldconfig -v
-
make altinstall
后无pip3
原因:altinstall
不会自动创建pip
软链接。 解决:手动创建软链接或通过python3 -m ensurepip
安装。
五、优化配置
-
配置国内 pip 源
mkdir -p ~/.pip && cat > ~/.pip/pip.conf << EOF [global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com EOF
-
更新 pip 与 setuptools
pip3 install --upgrade pip setuptools
总结:CentOS 7.9 安装 Python 3.10 的核心在于 OpenSSL 升级和依赖完整性检查。若遇到编译错误,优先检查依赖库是否齐全,并通过环境变量和编译参数确保 Python 正确链接所需组件。