在 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）
- 验证：
- 说明：可启用优化与自定义选项，适合需要特定版本或性能调优的场景。
四 安装后配置与虚拟环境
- 使用 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 的使用。
