Ubuntu上如何成功安装Python

在 Ubuntu 上安装 Python 的实用指南

一 快速安装 Python 3 与 pip

• 更新软件源并安装：
  • sudo apt update
  • sudo apt install python3 python3-pip
• 验证安装结果：
  • python3 --version
  • pip3 --version
• 说明：这是最简便、与系统兼容性最好的方式，适合大多数用户与日常开发。

二 使用 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
• 配置环境变量（写入 ~/.bashrc 或 ~/.zshrc）：
  • export PATH=“$HOME/.pyenv/bin:$PATH”
  • eval “$(pyenv init --path)”
  • eval “$(pyenv init -)”
  • eval “$(pyenv virtualenv-init -)”
  • 使配置生效：source ~/.bashrc
• 常用命令：
  • 查看可安装版本：pyenv install --list
  • 安装指定版本：pyenv install 3.x.x
  • 设置全局默认版本：pyenv global 3.x.x
  • 验证：python --version
• 说明：可在同一台机器上并行管理多个版本，避免与系统 Python 冲突。

三 从源码编译安装特定版本（进阶）

• 安装编译依赖：
  • sudo apt update
  • sudo apt install -y build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libsqlite3-dev libreadline-dev libffi-dev
• 下载并解压源码（以 3.x.x 为例）：
  • wget https://www.python.org/ftp/python/3.x.x/Python-3.x.x.tgz
  • tar -xf Python-3.x.x.tgz
  • cd Python-3.x.x
• 配置、编译与安装：
  • ./configure --enable-optimizations
  • make -j “$(nproc)”
  • sudo make altinstall（使用 altinstall 避免覆盖系统默认 python）
• 验证：
  • python3.x --version
• 说明：可启用优化与自定义选项，适合需要特定版本或性能调优的场景。

四 安装后配置与虚拟环境

• 使用 venv 创建隔离环境：
  • python3 -m venv .venv
  • 激活：source .venv/bin/activate
  • 退出：deactivate
• 升级 pip 并配置镜像（可选，提升国内下载速度）：
  • python3 -m pip install --upgrade pip
  • pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
• 说明：虚拟环境可避免不同项目依赖冲突，是 Python 开发的最佳实践。

五 常见问题与排错要点

• 命令未找到或版本不对：检查是否在 PATH 中，或明确使用 python3.x、pip3；若用 pyenv，确认已执行 init 并 source 配置文件。
• 编译失败：多为缺少依赖，按上文依赖清单补齐后重试。
• 多版本冲突：优先使用 pyenv 管理版本，避免直接替换系统 python。
• 权限问题：优先在用户目录或虚拟环境中安装包，必要时使用 --user 或虚拟环境，减少 sudo pip 的使用。