CentOS Python安装最佳实践分享

CentOS 上安装 Python 的最佳实践

一 版本选择与总体策略

• 新项目优先选择仍在维护的 Python 3.10（功能版）或 3.9（安全修复至 2025-10），兼顾生态兼容与安全性；如需长期稳定且依赖较旧，可考虑 3.8（安全修复至 2024-10）。避免使用已停止维护的 Python 2.x。
• 安装方式优先级：优先使用发行版仓库或 EPEL/IUS 提供的版本；需要多版本共存或特定小版本时，使用 pyenv；当仓库无法满足版本或性能诉求时，再从源码编译，且务必使用 make altinstall 避免覆盖系统 Python。
• 系统兼容性要点：CentOS 7 默认 Python 版本较低，常见做法是保留系统 Python 2.7 并新增 Python 3；CentOS 8/Stream 可直接通过仓库安装较新的 3.x。

二 三种常用安装方式对比

三 源码编译安装步骤（通用且可复用）

• 准备环境
  • 更新系统并安装编译依赖：sudo yum update -y；sudo yum groupinstall “Development Tools” -y；sudo yum install -y gcc zlib-devel bzip2-devel openssl-devel readline-devel sqlite-devel tk-devel libffi-devel xz-devel。
• 下载与配置
  • 从 python.org 下载所需版本源码，解压后进入目录：./configure --prefix=/usr/local/python3.10 --enable-optimizations --with-ssl（–with-ssl 确保 pip 可用 HTTPS 源）。
• 编译与安装
  • 并行编译：make -j$(nproc)；安装：make altinstall（生成如 python3.10、pip3.10，避免覆盖系统 python）。
• 环境变量与验证
  • 将新 Python 加入 PATH：echo ‘export PATH=/usr/local/python3.10/bin:$PATH’ >> ~/.bashrc && source ~/.bashrc；验证：python3.10 --version、pip3.10 --version。
• 可选优化（第三方扩展依赖共享库时）
  • 启用共享库：在 ./configure 后增加 LDFLAGS=“-Wl,-rpath /usr/local/lib”；或把 /usr/local/lib 加入 /etc/ld.so.conf 并执行 ldconfig。

四 多版本共存与安全加固

• 多版本共存与切换
  • 使用 pyenv 管理多版本（pyenv install/ global/ local），或按需创建软链接（如 ln -s /usr/local/python3.10/bin/python3.10 /usr/local/bin/python3.10），避免替换 /usr/bin/python。
  • 若必须调整系统默认 python 命令，使用 alternatives 机制：sudo alternatives --install /usr/bin/python python /usr/local/bin/python3.10 2；sudo alternatives --config python。
• 虚拟环境与依赖管理
  • 始终在项目目录内创建隔离环境：python3.10 -m venv .venv && source .venv/bin/activate；使用 pip 安装依赖并固化：pip freeze > requirements.txt。
• 加速与离线安装
  • 配置国内镜像源加速：pip install -i https://mirrors.aliyun.com/pypi/simple/ 包名；离线环境：pip download -r requirements.txt -d /tmp/pkgs；在内网执行：pip install --no-index --find-links=/tmp/pkgs -r requirements.txt。
• 系统稳定性与兼容性
  • 不要删除或替换系统自带的 Python 2.7（如 CentOS 7 的 yum 等工具依赖）；涉及编译第三方模块（如某些 C 扩展）时，提前安装对应 -devel 包以避免 “ModuleNotFoundError: No module named ‘_ctypes’” 等错误。