Ubuntu 如何顺利安装 Python

Ubuntu 安装 Python 的稳妥流程

一 安装前准备

• 确认系统版本与架构：在终端执行 lsb_release -a，了解是 20.04/22.04/24.04 等，以便选择合适版本与仓库。
• 更新索引并升级系统：执行 sudo apt update && sudo apt upgrade -y，减少依赖冲突。
• 安装常用构建依赖（后续编译或某些 pip 包会用到）：
  sudo apt install -y build-essential zlib1g-dev libbz2-dev libreadline-dev
  libsqlite3-dev libssl-dev libffi-dev libncurses5-dev libncursesw5-dev
  xz-utils tk-dev liblzma-dev wget curl llvm python3-openssl
• 版本选择建议：新项目优先 Python 3.12.x；数据科学 3.9–3.11；机器学习 3.8–3.11；Web 3.8+。注意 Python 2 已于 2020 年停止支持，除非维护遗留项目，不建议使用。

二 三种安装方式

• 方式一 APT 安装（推荐，简单稳妥）

  1. 安装基础命令与 pip：
     sudo apt update
     sudo apt install -y python3 python3-pip
  2. 如需特定小版本（示例为 3.12）：
     sudo apt install -y python3.12 python3.12-venv python3.12-distutils
  3. 验证：
     python3.12 --version
     pip3.12 --version
     说明：Ubuntu 20.04 默认 3.8，22.04 默认 3.10；若官方仓库版本不够新，见下节“版本选择与切换”。

• 方式二 编译安装（可定制与获取最新版本）

  1. 下载源码（以 3.12.8 为例）：
     wget https://www.python.org/ftp/python/3.12.8/Python-3.12.8.tgz
     tar -xvf Python-3.12.8.tgz && cd Python-3.12.8
  2. 配置与编译（–enable-optimizations 会显著延长编译时间，可按需关闭）：
     ./configure --enable-optimizations
     make -j “$(nproc)”
  3. 安装（使用 altinstall 避免覆盖系统 python3）：
     sudo make altinstall
  4. 验证：
     python3.12 --version
     提示：如需同时保留多个版本，编译安装配合版本管理更方便。

• 方式三 版本管理工具 Pyenv（多版本并存与切换）

  1. 安装 pyenv：
     curl https://pyenv.run | bash
  2. 配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）：
     echo ‘export PATH=“$HOME/.pyenv/bin:$PATH”’ >> ~/.bashrc
     echo ‘eval “$(pyenv init --path)”’ >> ~/.bashrc
     echo ‘eval “$(pyenv virtualenv-init -)”’ >> ~/.bashrc
     source ~/.bashrc
  3. 安装与切换版本：
     pyenv install 3.12.8
     pyenv global 3.12.8 # 或 pyenv local 3.12.8 仅当前项目生效
  4. 验证：
     python --version
     说明：pyenv 便于在 3.8–3.12 等版本间快速切换，适合开发与测试多版本兼容。

三 版本选择与切换

• 使用系统仓库或 deadsnakes PPA 获取更多小版本（示例为 3.11）：
  sudo add-apt-repository ppa:deadsnakes/ppa
  sudo apt update
  sudo apt install -y python3.11 python3.11-venv
• 使用 alternatives 设置系统默认 python3（示例将 3.12 设为默认）：
  sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 100
  sudo update-alternatives --config python3 # 交互选择
• 注意：不要随意替换系统自带的 /usr/bin/python3，以免影响 apt 等系统工具；优先使用 python3.x 与 python3.x -m venv 的方式隔离环境。

四 验证与虚拟环境

• 验证安装：
  python3.12 --version
  pip3.12 --version
• 升级 pip 并配置镜像（可选，提升国内下载速度）：
  python3.12 -m pip install -U pip
  python3.12 -m pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
• 创建与使用虚拟环境（强烈推荐）：
  python3.12 -m venv .venv
  source .venv/bin/activate
  pip install -r requirements.txt
  deactivate
• 数据科学场景可选 Anaconda/Miniconda：下载安装脚本后执行 bash Anaconda3-*.sh，使用 conda create -n myenv python=3.11 创建隔离环境。

五 常见问题与排错

• 命令未找到或版本不对：确认是否安装了对应 python3.x 与 python3.x-venv，并使用 python3.x -m venv 创建环境，避免依赖系统默认解释器。
• 依赖缺失导致编译失败：按“安装前准备”补齐 build-essential、libssl-dev、libffi-dev 等依赖后重试。
• 多版本并存冲突：使用 pyenv 或 update-alternatives 管理版本，项目内优先使用 venv。
• 权限与安全性：不要以 root 日常使用 pip；优先在用户目录或虚拟环境内安装包。
• 需要更高版本或新特性：若官方仓库版本滞后，使用 deadsnakes PPA 或 源码编译；涉及生产环境变更前先在测试环境验证。