Python环境在CentOS如何搭建

在 CentOS 上搭建 Python 环境的实用步骤

一 准备与系统检查

• 更新系统并安装基础工具：
  • 命令：sudo yum update -y && sudo yum install -y wget gcc
• 查看现有 Python：
  • 命令：python --version、python3 --version
• 注意：不要删除系统自带的 Python 2.x（如 /usr/bin/python），因为 yum 等系统工具依赖它。推荐安装并使用 Python 3.x 的新可执行文件（如 python3 或自定义软链）。

二 三种常用安装方式

• 方式一 使用 YUM 快速安装（适合快速上手）

  • 安装：sudo yum install -y python3 python3-pip
  • 验证：python3 --version、pip3 --version
  • 说明：版本由仓库决定，可能不是最新小版本。

• 方式二 使用 IUS 仓库安装指定小版本（如 3.8、3.9）

  • 安装仓库与包：
    • sudo yum install -y epel-release
    • CentOS 7：sudo yum install -y https://repo.ius.io/ius-release-el7.rpm
    • 安装具体版本：sudo yum install -y python38 python38-pip（或 python39 python39-pip）
  • 验证：python3.8 --version、pip3.8 --version
  • 说明：IUS 提供较新的 python3x 与 python3x-pip 包，便于精确控制小版本。

• 方式三 从源码编译安装（可定制与获取最新版本）

  • 安装编译依赖：
    • sudo yum groupinstall -y "Development Tools"
    • sudo yum install -y openssl-devel bzip2-devel libffi-devel zlib-devel readline-devel sqlite-devel wget
  • 下载与编译（示例版本 3.9.9，可按需替换）：
    • wget https://www.python.org/ftp/python/3.9.9/Python-3.9.9.tgz
    • tar xvf Python-3.9.9.tgz && cd Python-3.9.9
    • ./configure --prefix=/usr/local/python3.9 --enable-optimizations
    • make -j "$(nproc)" && sudo make altinstall
  • 验证：python3.9 --version
  • 说明：使用 –enable-optimizations 会进行额外优化，编译更慢；使用 make altinstall 避免覆盖系统默认 python。如需软链：sudo ln -s /usr/local/python3.9/bin/python3.9 /usr/bin/python3.9、sudo ln -s /usr/local/python3.9/bin/pip3.9 /usr/bin/pip3.9。

三 多版本管理与虚拟环境

• 使用 pyenv 管理多版本

  • 安装与初始化：
    • sudo yum install -y git
    • curl https://pyenv.run | bash
    • 写入 Shell 配置（~/.bashrc 或 ~/.bash_profile）：
      • echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> ~/.bashrc
      • echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
      • echo 'eval "$(pyenv init -)"' >> ~/.bashrc
      • 可选：echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
    • 使配置生效：source ~/.bashrc
  • 常用命令：
    • 安装版本：pyenv install 3.9.9
    • 全局默认：pyenv global 3.9.9
    • 验证：python --version
  • 说明：pyenv 可在同一台机器上轻松切换多个 Python 版本，适合开发与测试。

• 使用 venv 创建隔离的虚拟环境

  • 创建与激活：
    • python3 -m venv venv（或 python3.9 -m venv venv）
    • source venv/bin/activate
  • 常用操作：
    • 升级 pip：pip install --upgrade pip
    • 安装依赖：pip install -r requirements.txt
    • 退出：deactivate
  • 说明：venv 是官方推荐的依赖隔离方式，避免项目间版本冲突。

四 常见问题与实用建议

• 编译时报错 ModuleNotFoundError: No module named ‘_ctypes’：缺少 libffi-devel，安装后重新编译：sudo yum install -y libffi-devel。
• 不要替换系统 /usr/bin/python；如需便捷调用，使用自定义软链或在 PATH 中优先放置新 bin 目录（如 /usr/local/python3.9/bin:$PATH）。
• 升级 pip 后若命令找不到，检查 PATH 是否包含对应 bin 目录，或使用 python -m pip 方式调用（如 python3.9 -m pip install --upgrade pip）。
• 生产部署建议：为每个项目使用独立的 venv，并通过 pyenv 固定 Python 小版本；涉及 Web 服务时，可结合 Nginx + Gunicorn 部署应用。