然有了 docker，为啥还需要编译安装 Python 呢，是不是自找麻烦。 docker 是方便，但是如果机器本身就自带 Python 最新版本，作为一个开发环境，岂不更方便？

笔者编译安装过不下 10 次，每次还是被这个错误浪费不少时间，今天就总结一下，让你在编译安装 Python 的过程中避坑。

步骤 1: 安装依赖

在编译 Python 之前，你需要确保你的系统安装了所有必须的构建依赖。在基于 Debian 的系统上，像 Ubuntu 这样的，可以这样做：

sudo apt update
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev \
libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev libbz2-dev

对于基于 Red Hat 的系统，比如 CentOS 或者 Fedora，可以这样做：

sudo yum groupinstall "Development Tools"
sudo yum install zlib-devel bzip2-devel openssl-devel ncurses-devel \
sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel libffi-devel

步骤 2: 下载 Python 源码

可以从 Python 官方网站或其在 GitHub 的镜像库下载源码。使用 wget 从官方源下载的命令：

wget https://www.python.org/ftp/python/3.12.3/Python-3.12.3.tgz

然后解压下载的文件：

tar -xvzf Python-3.12.3.tgz

解压后，切换到源码目录：

cd Python-3.12.3

步骤 3: 配置编译选项

在编译之前，配置安装选项，可以使用 ./configure 脚本。可以指定诸如安装目录的选项（通过 --prefix 参数）和编译优化（在 Python 3.12，通过 --enable-optimizations 开启编译优化可能会显著提升 Python 性能但是会使编译过程更长）。

./configure --enable-optimizations --prefix=/usr/local/python3.12

这里，我们将 Python 安装到 /usr/local/python3.12，然后手动添加 Path，这样不会影响其他版本的 Python，比如 python2.

还有许多其他的配置选项，可以通过运行 ./configure --help 来查看它们。

步骤 4: 编译 Python

运行 make 命令来编译 Python：

make -j 8   # '8' 是编译时使用的核心数，根据你的系统调整

由于编译时间较长，我们可以使用 -j 选项会在编译时进行并行处理，以加快编译速度。这个数字最好设置为你的处理器核心数。

到这里，我们通常会遇到 ssl 报错：

Could not build the ssl module!
Python requires a OpenSSL 1.1.1 or newer

而操作系统上的 openssl 通常都是低于 1.1.1 的，遇到这种情况，就 openssl 官网下载新版本，编译安装，然后把相关的库收集到安装路径的 lib 目录即可。但是安装 openssl 通常也不是那么顺利的。根据以下步骤进行

mkdir ~/openssl
cd ~/openssl
wget https://www.openssl.org/source/openssl-3.3.0.tar.gz
tar -zxvf openssl-3.3.0.tar.gz
cd openssl-3.3.0
./config --prefix=/usr/local/ssl3.3 --openssldir=/usr/local/ssl3.3 shared zlib
make
make install

如果上述步骤在 config 步骤报错：Can't locate IPC/Cmd.pm in @INC ，则需要安装下面的依赖包：

sudo yum groupinstall 'Development Tools'
sudo yum install perl-core zlib-devel

上述的步骤将 openssl 安装在 /usr/local/ssl3.3 下面，我们可以在命令行（terminal）执行 /usr/local/ssl3.3/bin/openss version 如果执行报错，则需要指定 lib64 的路径 :

sudo vim sudo vim /etc/ld.so.conf.d/openssl.conf
# 加入内容 /usr/local/ssl3.3/lib64
sudo ldconfig

然后在执行 /usr/local/ssl3.3/bin/openss version 即可看到正确的版本信息。

但是编译 Python 之前，还有一个关键的步骤，就是需要在 /usr/local/ssl3.3/ 下创建一个 lib 文件，然后将相应的 so 文件放进去，通过执行下面的命令：

cd ~/openssl/openssl-3.3.0 # 确保再解压的目录中
mkdir /usr/local/ssl3.3/lib
cp ./*.{so,so.3*,a,pc} /usr/local/ssl3.3/lib

步骤 5: 再次配置、编译 Python

运行 make 命令来编译 Python：

./configure --with-openssl=/usr/local/ssl3.3 --prefix=/usr/local/python3.12
make -j 8   # '8' 是编译时使用的核心数，根据你的系统调整

这次就可以顺利完成编译了。

步骤 6: 安装 Python

一旦编译完成，运行以下命令以安装 Python：

sudo make install

我们不需要使用 altinstall 是因为我们指定了自己的安装目录 /usr/local/python3.12。如果不指定安装目录，为了避免替换掉系统的默认 Python 版本，可以使用 altinstall。

步骤 6: 验证安装

安装完成后，可以通过调用新安装的 Python 版本来检查它：

/usr/local/bin/python3.12 --version

输出应该显示 Python 的版本号。进入 Python 后，执行 import ssl 验证安装。

$ /usr/local/python3.12/bin/python3
Python 3.12.3 (main, May 23 2024, 15:08:26) [GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import ssl
>>> ssl.OPENSSL_VERSION
'OpenSSL 3.3.0 9 Apr 2024'
>>>

至此完成安装。

参考链接

https://stackoverflow.com/questions/53543477/building-python-3-7-1-ssl-module-failed

以上以上，如有帮助欢迎点赞关注转发，遇到问题也可以联系微信 somenzz-enjoy。