如何在CentOS上配置Python解释器

在 CentOS 上配置 Python 解释器，是不少开发者在服务器部署项目时绕不开的一步。系统自带的 Python 2.7 主要用于系统工具（比如 yum），而现代应用大多需要 Python 3。接下来我们就一步步把这件事理顺——从检查现有版本，到编译安装、配置虚拟环境，再到常见问题的应对，全流程走一遍。

一、检查系统自带Python版本

CentOS 通常预装 Python 2.7，先确认当前环境里到底有什么：

python --version      # 查看Python 2版本（若存在）
python3 --version     # 查看是否预装Python 3

如果已有版本满足项目需求，就不用重复安装；如果需要特定版本（比如 Python 3.9+），继续往下走。

二、安装Python依赖包

编译 Python 源码依赖多个开发库，一气呵成装好：

sudo yum install -y zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gcc make libffi-devel xz-devel

三、下载并编译安装Python解释器

1. 下载Python源码包

选好版本（这里以 3.9.0 为例），用 wget 拉下来：

cd /tmp   # 临时目录存放安装包
wget https://www.python.org/ftp/python/3.9.0/Python-3.9.0.tgz
tar zxvf Python-3.9.0.tgz   # 解压
cd Python-3.9.0              # 进入解压目录

2. 配置安装路径

指定安装目录（比如 /usr/local/python39），避免覆盖系统默认的 Python：

./configure --prefix=/usr/local/python39

3. 编译并安装

make && sudo make install   # 编译并安装到指定目录

4. 创建软链接（可选）

把 Python 和 pip 命令链接到系统路径，方便全局调用：

cd /usr/local/python39/bin
sudo cp python3 python   # 复制python3为python
sudo cp pip3 pip         # 复制pip3为pip
sudo chmod +x python pip  # 添加执行权限

四、配置环境变量

编辑系统环境变量文件，把 Python 路径加到 PATH 里：

sudo vi /etc/profile   # 使用root权限编辑

在文件末尾添加以下内容（替换为实际安装路径）：

export PATH=/usr/local/python39/bin:$PATH

保存后使配置生效：

source /etc/profile

验证一下：

echo $PATH   # 应包含/usr/local/python39/bin

五、验证Python安装

python --version   # 应显示安装的Python版本（如3.9.0）
pip --version      # 验证pip是否可用

六、配置Python虚拟环境（推荐）

虚拟环境能隔离项目依赖，避免版本冲突，强烈建议配一下。

1. 安装virtualenvwrapper

sudo yum install -y epel-release   # 安装EPEL仓库
sudo yum install -y python3-virtualenv   # 安装virtualenv
pip install virtualenvwrapper            # 安装virtualenvwrapper

2. 配置虚拟环境目录

编辑用户配置文件（如 ~/.bashrc）：

vi ~/.bashrc

添加以下内容（替换为实际 Python 解释器路径）：

export WORKON_HOME=$HOME/.virtualenvs                    # 虚拟环境存储目录
export VIRTUALENVWRAPPER_PYTHON=/usr/local/python39/bin/python   # 指定Python解释器
source /usr/local/python39/bin/virtualenvwrapper.sh    # 加载virtualenvwrapper

保存后使配置生效：

source ~/.bashrc

3. 创建并激活虚拟环境

mkvirtualenv myenv      # 创建名为myenv的虚拟环境
workon myenv            # 激活虚拟环境（终端提示符会显示环境名）
deactivate              # 退出虚拟环境

七、常见问题解决

1. 编译时出现“Could not build the ssl module”

这通常是因为 OpenSSL 版本或路径不对。需要重新编译 OpenSSL 并指定路径：

# 卸载旧版OpenSSL（若有）
sudo yum remove openssl
# 下载并编译OpenSSL（以1.1.1为例）
wget https://www.openssl.org/source/openssl-1.1.1.tar.gz
tar zxvf openssl-1.1.1.tar.gz
cd openssl-1.1.1
./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl
make && sudo make install
# 重新配置Python，指定OpenSSL路径
cd /tmp/Python-3.9.0
./configure --prefix=/usr/local/python39 --with-openssl=/usr/local/openssl
make && sudo make install

2. yum无法使用（因替换系统Python）

如果替换了系统默认的 Python，yum 可能会报错。解决办法是修改 yum 相关配置文件，强制指定 Python 2：

sudo vi /usr/libexec/urlgrabber-ext-down

将首行 #!/usr/bin/python 改为 #!/usr/bin/python2；同理修改 /usr/bin/yum 文件的首行。