Ubuntu 如何安装 Python 环境

Ubuntu 安装与配置 Python 环境

一 快速安装 Python 3 与 pip

• 更新索引并安装基础组件：
  • sudo apt update
  • sudo apt install -y python3 python3-pip
• 验证安装结果：
  • python3 --version
  • pip3 --version
• 说明：大多数 Ubuntu 版本已预装 Python 3，上述步骤用于确保版本与 pip 到位并可正常使用。

二 安装特定版本或较新版本

• 使用 Debian 官方仓库安装指定小版本（若仓库提供）：
  • sudo apt install -y python3.10
• 使用 Dead Snakes PPA 获取更多版本（示例为 3.8）：
  • sudo add-apt-repository -y universe
  • sudo apt install -y software-properties-common
  • sudo add-apt-repository -y ppa:deadsnakes/ppa
  • sudo apt update
  • sudo apt install -y python3.8
• 验证：
  • python3.8 --version
• 提示：不同 Ubuntu 版本的仓库可用版本不同，PPA 是获取较新或更多小版本的常用方式。

三 多版本管理与隔离

• 使用 pyenv 管理多个 Python 版本（适合开发与测试多版本共存）：
  • 安装依赖：
    • sudo apt update
    • sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl git
  • 安装 pyenv：
    • curl https://pyenv.run | bash
  • 配置 Shell（写入 ~/.bashrc 或 ~/.zshrc）：
    • export PATH=“$HOME/.pyenv/bin:$PATH”
    • eval “$(pyenv init --path)”
    • eval “$(pyenv init -)”
    • eval “$(pyenv virtualenv-init -)”
    • source ~/.bashrc
  • 安装与切换版本：
    • pyenv install 3.11.9
    • pyenv global 3.11.9
    • python --version
• 使用 venv 隔离项目依赖（推荐在每个项目目录内创建）：
  • python3 -m venv .venv
  • source .venv/bin/activate
  • pip install -U pip
  • deactivate
• 说明：pyenv 负责多版本切换，venv 负责项目级依赖隔离，两者配合可避免版本与依赖冲突。

四 从源码编译安装（高级）

• 安装构建依赖：
  • sudo apt update
  • sudo apt install -y build-essential libssl-dev libffi-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev
• 下载并编译（以 3.12.7 为例）：
  • wget https://www.python.org/ftp/python/3.12.7/Python-3.12.7.tgz
  • tar -xf Python-3.12.7.tgz
  • cd Python-3.12.7
  • ./configure --enable-optimizations
  • make -j $(nproc)
  • sudo make altinstall
• 验证：
  • python3.12 --version
• 要点：使用 –enable-optimizations 提升性能；使用 make altinstall 避免覆盖系统默认 python3。

五 常见问题与实用建议

• 命令未找到或版本不对：确认已执行 source ~/.bashrc 重载配置；使用 which python 与 which pip 检查可执行文件路径；必要时检查 PATH 是否包含 ~/.pyenv/bin 或虚拟环境目录。
• pip 安装包慢或失败：可临时使用国内镜像，例如：
  • pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名
• 何时选择哪种方式：
  • 日常开发与运维：优先用 APT 安装系统仓库版本并配合 venv。
  • 需要多版本并存或测试新版本：使用 pyenv。
  • 需要特定编译选项或最新小版本：从源码 编译安装。
• 安全与维护：避免替换系统自带 /usr/bin/python3；优先使用 python3.x 与 python3.x -m pip 明确指向；定期更新系统与包索引（sudo apt update）。