CentOS 7/8 安装 Python 3：详细步骤与避坑指南 – wiki大全

作者： /

CentOS 7/8 安装 Python 3：详细步骤与避坑指南

Python 3 作为现代编程语言的基石，在开发、数据科学和系统自动化等领域扮演着至关重要的角色。然而，在 CentOS 这样的企业级 Linux 发行版上安装 Python 3，尤其是与系统自带的 Python 版本共存时，需要细致的操作以避免潜在的系统问题。本文将详细介绍在 CentOS 7 和 CentOS 8 上安装 Python 3 的步骤，并提供关键的避坑指南。

前言：理解 CentOS 与 Python

  • CentOS 7： 默认预装 Python 2.x 版本。特别重要的是，许多系统工具（如 yum）严重依赖 Python 2。 因此，在 CentOS 7 上安装 Python 3 时，绝不能直接替换系统自带的 Python 2，而应采取共存策略。推荐通过源码编译安装最新版本。
  • CentOS 8： 默认不预装 Python，但其官方仓库中提供了 Python 3。这使得在 CentOS 8 上安装 Python 3 相对简单，推荐使用 dnf 包管理器。

CentOS 7 安装 Python 3 详细步骤 (推荐源码编译)

由于 CentOS 7 仓库中的 Python 3 版本可能较旧，且系统对 Python 2 存在强依赖，推荐通过源码编译方式安装最新版本的 Python 3。

步骤 1：安装开发工具和依赖库

在编译 Python 3 之前，需要安装一系列必要的开发工具和库，以确保 Python 3 的所有功能（特别是 pip 正常工作所需的 SSL 模块）能够正确编译。

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

⚠️ 避坑提示：
* openssl-devel 和 libffi-devel 对于解决 pip 安装包时可能出现的 SSL 模块错误至关重要。如果缺少这些库，可能会导致 pip 无法正常访问 PyPI。

步骤 2：下载 Python 3 源码包

访问 Python 官方网站 (www.python.org) 下载最新稳定版本的 Python 3 源码包。请将 3.x.x 替换为实际版本号。

“`bash

进入一个合适的目录，例如 /usr/local/src

cd /usr/local/src

下载 Python 源码包，请替换为最新的稳定版本链接

示例：sudo wget https://www.python.org/ftp/python/3.10.12/Python-3.10.12.tgz

sudo wget https://www.python.org/ftp/python/3.x.x/Python-3.x.x.tgz

解压源码包

sudo tar -zxvf Python-3.x.x.tgz
“`

步骤 3：编译并安装 Python 3

进入解压后的目录，配置、编译并安装 Python 3。

“`bash
cd Python-3.x.x

配置编译选项

–enable-optimizations 可以优化 Python 性能，但编译时间较长。

–with-openssl 确保 Python 支持 SSL。

–prefix=/usr/local/python3 指定了 Python 3 的安装路径。

sudo ./configure –enable-optimizations –with-openssl –prefix=/usr/local/python3

编译 (利用多核 CPU 加速编译)

sudo make -j $(nproc)

安装

sudo make install
“`

⚠️ 避坑提示：
* --prefix=/usr/local/python3：强烈建议不要将 Python 3 安装到 /usr/bin 或 /bin 等系统路径，以避免与系统自带的 Python 2 冲突，从而破坏系统稳定性。 将其安装在 /usr/local/python3 是一个安全且规范的做法。
* 如果在编译过程中遇到 SSL 模块错误，通常是缺少 openssl-devel 或其版本不兼容。请确保已安装正确版本的 openssl-devel，并重新运行 ./configure 和 make install。

步骤 4：建立软链接

为了方便在命令行中直接使用 python3 和 pip3 命令，需要创建软链接。

“`bash

创建 Python 3 的软链接

sudo ln -s /usr/local/python3/bin/python3 /usr/bin/python3
sudo ln -s /usr/local/python3/bin/pip3 /usr/bin/pip3
“`

⚠️ 避坑提示：
* 绝对不要将 /usr/bin/python 软链接指向 Python 3！ 这会破坏 yum 等依赖 Python 2 的系统工具，导致系统功能异常。
* 始终通过明确使用 python3 和 pip3 命令来调用新安装的 Python 3 及其包管理器。

步骤 5：修改 yum 配置 (关键避坑)

由于 yum 在 CentOS 7 上依赖 Python 2，如果系统默认的 python 命令被修改，yum 将无法工作。这一步是确保系统工具正常运行的关键。

“`bash

修改 yum 主程序，明确指定其使用 Python 2

sudo sed -i ‘s/usr\/bin\/python/usr\/bin\/python2/g’ /usr/bin/yum

修改 yum 配置文件，明确指定其使用 Python 2

sudo sed -i ‘s/usr\/bin\/python/usr\/bin\/python2/g’ /etc/yum.conf
“`

⚠️ 避坑提示： 这一步是 CentOS 7 上安装 Python 3 最重要的避坑措施之一。务必执行，否则 yum 将会报错。

步骤 6：验证安装

检查 Python 3 和 pip 3 的版本，确认安装成功。

bash
python3 --version
pip3 --version

CentOS 8 安装 Python 3 详细步骤 (推荐 dnf 包管理器)

CentOS 8 默认不提供 python 命令，但其官方仓库中包含了 Python 3，因此推荐使用 dnf 包管理器进行安装。

步骤 1：更新系统

首先更新系统，确保获取到最新的软件包信息。

bash
sudo dnf update -y

步骤 2：使用 dnf 安装 Python 3

CentOS 8 的 dnf 包管理器可以直接安装 Python 3。

bash
sudo dnf install python3 -y

⚠️ 避坑提示：
* dnf install python3 命令通常会同时安装 pip3。
* CentOS 8 默认没有 python 命令，需要明确使用 python3。

3. 验证安装

检查 Python 3 和 pip 3 的版本。

bash
python3 --version
pip3 --version

4. 升级 pip 3 (可选但推荐)

安装后，建议升级 pip3 到最新版本，以获得更好的功能和安全性。

bash
sudo pip3 install --upgrade pip

5. 设置默认 Python 版本 (谨慎操作)

CentOS 8 默认不提供未版本化的 python 命令，以避免将用户锁定到特定版本。如果确实需要将 python 命令指向 Python 3，可以使用 alternatives 工具，但请务必谨慎操作，因为它可能影响依赖 python 命令的应用程序。

“`bash

查看当前的 alternatives 配置

sudo alternatives –display python

将 python 命令设置为指向 python3 (如果已安装)

sudo alternatives –set python /usr/bin/python3

或者，如果通过源码安装，路径可能是 /usr/local/python3/bin/python3

sudo alternatives –set python /usr/local/python3/bin/python3

“`

⚠️ 避坑提示： 除非您非常清楚其影响，否则不建议设置全局的 python 软链接。最好始终使用 python3 命令来避免潜在问题。

通用避坑指南 (适用于 CentOS 7/8)

无论您在哪种 CentOS 版本上安装 Python 3，以下通用避坑指南都将帮助您维护系统的稳定性和项目的隔离性。

  1. 不要破坏系统自带的 Python (尤其 CentOS 7)： 重申：CentOS 7 的 yum 和其他系统工具依赖 Python 2。直接替换或修改 /usr/bin/python 软链接可能导致系统工具无法使用。CentOS 8 虽然默认不带 python 命令，但如果通过 dnf 安装了 Python 3，系统工具也可能依赖 python3。始终使用 python3 和 pip3 命令来调用新安装的 Python 3。
  2. 使用虚拟环境 (Virtual Environments)： 强烈建议为每个 Python 项目创建独立的虚拟环境（如使用 venv 或 virtualenv）。这可以隔离项目依赖，避免不同项目之间的包版本冲突，并且无需修改系统全局的 Python 环境。
    • 安装 virtualenv：
      bash
      pip3 install virtualenv

    • 创建和激活虚拟环境：
      “`bash
      # 创建虚拟环境 (例如名为 myproject_env)
      python3 -m venv myproject_env

      激活虚拟环境

      source myproject_env/bin/activate

      退出虚拟环境

      deactivate
      ``
      * 使用虚拟环境后，      python和pip命令将指向虚拟环境中的版本，不会影响系统全局环境。
      3. **解决 SSL 模块问题 (源码编译时)：** 如果通过源码编译安装 Python 3，并且在使用      pip时遇到 SSL 相关的错误（例如pip无法连接到 PyPI），通常是缺少openssl-devel或编译时未正确链接 OpenSSL 库。确保在编译前安装了openssl-devel，并在./configure命令中包含–with-openssl选项。
      4. **      pip命令未找到或版本问题：** 确保pip3的软链接正确指向新安装的 Python 3 对应的pip可执行文件。安装 Python 3 后，通常会自带pip，但建议运行pip3 install –upgrade pip来更新pip到最新版本。
      5. **      PATH环境变量：** 确保/usr/local/python3/bin(或您自定义的安装路径) 已经添加到系统的PATH环境变量中，这样系统才能找到python3和pip3命令。通常在创建软链接后，如果软链接在/usr/bin等默认 PATH 路径下，则无需额外配置。
      6. **源码编译耗时：** 源码编译 Python 3 可能会花费一些时间，尤其是在性能较低的机器上。使用      make -j $(nproc)可以利用多核 CPU 加速编译过程。
      7. **选择合适的安装方式：**
      * **CentOS 7：** 推荐源码编译，因为系统仓库中的 Python 3 版本可能较旧，且需要与 Python 2 共存。
      * **CentOS 8：** 推荐使用      dnf` 包管理器安装，因为它更简单快捷，且仓库中通常有较新的 Python 3 版本。如果需要最新或特定版本的 Python 3，再考虑源码编译。

结论

在 CentOS 7/8 上安装 Python 3 并非难事，但需要注意系统环境的特殊性。对于 CentOS 7，务必采取源码编译和共存策略，并通过修改 yum 配置来保护系统稳定性。对于 CentOS 8，dnf 包管理器提供了更便捷的安装方式。无论哪种情况，使用虚拟环境都是管理 Python 项目依赖的最佳实践，可以有效避免版本冲突和系统污染。遵循本文的详细步骤和避坑指南，您将能够顺利地在 CentOS 环境中配置好 Python 3 开发环境。

滚动至顶部