Ubuntu中Python的安装教程

Ubuntu 中 Python 的安装与环境配置教程

一 安装前准备

在开始安装之前，先做好这几项准备工作，能让后续过程顺畅不少。

更新索引并升级系统：

打开终端，首先运行这条命令，确保你的软件包列表是最新的，同时升级所有可更新的包：

sudo apt update && sudo apt upgrade -y

确认系统版本与架构：

这一步主要是为了心里有数，知道自己在什么系统上操作，便于后续选择匹配的安装包。

lsb_release -a

安装常用构建依赖：

这步很关键，尤其是如果你打算从源码编译安装，或者后续某些 pip 包需要编译本地扩展时，这些依赖库必不可少。一口气装上，可以避免很多“找不到头文件”之类的报错。

sudo apt install -y 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 python3-dev python3-pip

需要说明的是，绝大多数 Ubuntu 发行版其实已经预装了 Python 3，只是版本可能比较旧。如果没有特殊需求，最稳妥快捷的方式还是直接使用系统自带的包管理器来安装或升级。

二 方法一 使用 APT 安装（推荐）

这是最直接、最省心的方式，适合绝大多数追求稳定、希望与系统保持最佳兼容性的用户。

安装 Python 3 与 pip：

一条命令，同时安装 Python 3 解释器和 pip 包管理工具。

sudo apt install -y python3 python3-pip

验证版本：

安装完成后，立刻验证一下，确认安装成功且版本符合预期。

python3 --version
pip3 --version

升级 pip（可选）：

系统仓库里的 pip 版本可能不是最新的，你可以选择将其升级到最新版。

python3 -m pip install --upgrade pip

总结一下，APT 安装法胜在简单稳定，与系统集成度高，是快速上手的首选。

三 方法二 安装特定版本（Debian 官方 PPA）

如果你需要的不是系统仓库里那个默认版本，而是一个特定的 Python 小版本（比如 3.7、3.8、3.10），那么通过添加第三方 PPA 仓库来安装是个不错的折中方案，既能获得特定版本，又能继续享受包管理器带来的维护便利。

启用 Universe 仓库并安装工具：

确保 Universe 仓库已启用，并安装管理 PPA 所需的工具。

sudo add-apt-repository universe
sudo apt install -y software-properties-common

添加 deadsnakes PPA 并安装指定版本：

这里以安装 Python 3.10 为例。这个 PPA 维护了大量 Python 的历史版本。

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.10 python3.10-venv python3.10-dev

验证：

安装后，使用带版本号的命令来验证。

python3.10 --version

这种方法非常适合那些项目要求特定 Python 版本，但又不想折腾源码编译的场景。

四 方法三 从源码编译安装（可定制与优化）

这是最灵活、也最“硬核”的方式。你可以获取最新的代码，自定义编译选项，甚至进行性能优化。当然，过程也相对复杂一些。

1. 安装构建依赖：

这一步就是回到我们“安装前准备”里已经完成的那部分，确保所有编译依赖都已就位。

2. 下载并解压源码：

以 Python 3.12.x 为例，从官网下载源码包并解压。

wget https://www.python.org/ftp/python/3.12.x/Python-3.12.x.tgz
tar -xf Python-3.12.x.tgz && cd Python-3.12.x

3. 配置与编译：

运行配置脚本。这里的 --enable-optimizations 选项会进行一些性能优化，但会显著增加编译时间，请根据你的耐心和需求决定是否添加。

./configure --enable-optimizations
make -j $(nproc)

4. 安装：

强烈建议使用 altinstall 而不是普通的 install。这样可以避免覆盖系统默认的 python3 命令，防止某些系统工具因 Python 版本变化而出现意外。

sudo make altinstall

5. 验证：

编译安装完成后，验证新安装的版本。

python3.12 --version

提示：

如果你希望更方便地在任意位置调用这个新版本，可以手动创建一个软链接到系统路径（如 /usr/bin/）。但操作需谨慎，避免与现有命令冲突。

sudo ln -s /usr/local/bin/python3.12 /usr/bin/python3.12

源码编译适用于需要最新版本、特定功能模块，或希望对 Python 本身进行深度定制的用户。

五 虚拟环境与多版本管理

Python 开发中，隔离项目依赖和管理多个版本是两项必备技能。这里介绍几种主流工具。

1. 使用内置 venv 创建隔离环境（推荐）：

Python 3.3 以后就自带了 venv 模块，用它创建虚拟环境简单又标准。

python3 -m venv venv
source venv/bin/activate
要退出环境，只需执行：deactivate

2. 使用 pyenv 管理多版本：

如果你需要在同一台机器上频繁切换多个 Python 版本进行开发和测试，pyenv 是神器。

• 安装依赖： 同样需要“安装前准备”中的编译依赖。
• 安装 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.10.12
  设置全局版本：pyenv global 3.10.12
  设置本地目录版本：pyenv local 3.9.18
  查看已安装版本：pyenv versions

3. 使用 update-alternatives 切换系统默认 python：

这是一个系统级的工具，可以管理同一个命令的多个候选版本。但请注意，更改系统默认的 python 命令可能会影响某些依赖它的系统脚本或工具，操作前请明确后果。

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.12 2
sudo update-alternatives --config python

掌握虚拟环境和多版本管理，你就能轻松应对不同项目对依赖和 Python 版本的不同要求，让开发环境保持清晰和有序。