Ubuntu系统中如何管理和切换Python版本

Ubuntu系统中Python版本控制的常用方法

在Ubuntu系统中管理多个Python版本，几乎是每位开发者都会碰到的实际需求。无论你是为了兼容旧项目、部署指定运行环境，还是体验Python新版本特性，一套高效稳定的Python版本控制方案都非常重要。下面将从最灵活的工具开始，依次介绍系统级切换、手动切换以及虚拟环境隔离等常见做法，帮助你更好地在Ubuntu上管理Python版本。

1. 使用pyenv：灵活管理多版本Python

如果你需要在多个Python版本之间频繁切换，pyenv 几乎是目前社区中最主流、也最实用的方案之一。它支持多个Python版本共存，既能设置全局默认版本，也能为某个项目目录单独指定版本，还可以和虚拟环境工具无缝结合，是Ubuntu下进行Python版本管理的热门选择。

• 安装pyenv及依赖：首先需要安装编译Python常用的系统依赖包，否则后续安装指定Python版本时很容易报错。接着通过curl命令安装pyenv，再配置环境变量使其生效。

  # 安装依赖包
  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）
  echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
  echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
  echo 'eval "$(pyenv init --path)"' >> ~/.bashrc
  echo 'eval "$(pyenv init -)"' >> ~/.bashrc
  echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc  # 可选，集成virtualenv
  source ~/.bashrc  # 重新加载配置
  

• 安装与管理Python版本：执行 pyenv install --list 可以查看可安装的Python版本列表（例如3.8.10、3.9.5等），选定后使用 pyenv install 安装即可。通过 pyenv versions 可以查看当前已安装的全部版本，带有 * 标记的就是当前正在使用的版本。

• 切换Python版本：pyenv提供了三种常见的版本切换方式，适用于不同范围的使用场景。

  • 全局设置（所有终端默认生效）：pyenv global ，例如 pyenv global 3.8.10；
  • 局部设置（仅当前项目目录生效，会生成一个 .python-version 文件）：pyenv local ，非常适合项目级Python版本锁定；
  • 临时设置（仅当前shell会话有效）：pyenv shell 。

• 卸载与更新：如果不再需要某个版本，可以使用 pyenv uninstall 删除；更新pyenv本身则可执行 pyenv update。

2. 使用update-alternatives：系统级版本切换

如果你的需求只是切换系统默认的 python3 指向，而不需要像pyenv那样细化到项目层面，那么Ubuntu自带的 update-alternatives 工具就已经足够。它本质上是一个用于管理符号链接的系统工具，非常适合进行Ubuntu系统级的Python默认版本切换。

• 添加Python版本到alternatives：以Python 3.8和3.9为例，先通过apt安装对应版本的软件包（sudo apt install python3.8 python3.9），然后将它们注册到alternatives系统中：

  sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1   # 优先级1
  sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 2   # 优先级2（数值越大优先级越高）
  

• 切换默认版本：运行 sudo update-alternatives --config python3，终端会列出所有已注册的Python版本及其编号，输入目标版本对应的数字序号即可完成切换。

• 注意事项：这种方法只会修改 python3 命令的默认指向，不会影响 python 命令（在部分Ubuntu环境中，python 可能仍指向Python 2）。同时也要特别谨慎：不要随意替换系统自带的默认Python版本，因为很多系统组件和工具（例如apt）依赖特定版本，错误修改可能影响系统稳定性。

3. 手动配置软链接：简单直接的版本切换

最基础的方式就是手动创建软链接。如果你只是想临时切换到另一个Python版本来运行脚本，或者当前设备没有安装额外的版本管理工具，这种方法确实直接有效。不过它需要人工维护符号链接，灵活性较差，操作不当的风险也更高。

• 操作步骤：
  1. 先找到目标Python版本的完整路径（例如 /usr/bin/python3.9）；
  2. 删除原有的 python 软链接：sudo rm /usr/bin/python；
  3. 重新创建软链接并指向目标版本：sudo ln -s /usr/bin/python3.9 /usr/bin/python。
• 验证：执行 python --version，确认当前实际生效的Python版本号。
• 注意：直接修改系统级的 /usr/bin/python 链接，可能导致依赖旧版本解释器的系统工具或脚本异常。除非你非常明确自己的操作影响，否则一般不建议在生产环境或日常系统环境中使用这种方式。

4. 虚拟环境：隔离项目依赖与版本

无论你采用哪一种Python版本控制方法，虚拟环境 都是项目开发中非常关键的一环。它可以为每个项目创建独立的Python运行环境和依赖包空间，避免不同项目之间出现依赖冲突，是Ubuntu下进行Python开发的基础实践。

• 使用venv（Python标准库）：Python 3.3及以上版本都内置了 venv 模块，创建和使用虚拟环境都很方便：

  # 创建虚拟环境（指定Python版本，例如3.8）
  python3.8 -m venv myenv
  
  # 激活虚拟环境
  source myenv/bin/activate
  
  # 激活后，终端提示符会显示 (myenv)，此时pip安装的包都会存放到这个虚拟环境中
  # 停用虚拟环境
  deactivate
  

• 使用virtualenv（第三方工具）：如果项目需要兼容更早期的Python版本，也可以选择 virtualenv：

  pip install virtualenv
  virtualenv -p /usr/bin/python3.8 myenv  # 指定Python版本创建虚拟环境
  source myenv/bin/activate               # 激活
  

• 结合pyenv使用：如果你已经在Ubuntu中安装了pyenv，还可以配合其虚拟环境插件进一步提升效率。例如执行 pyenv virtualenv 3.8.10 myproject，就能快速创建一个基于Python 3.8.10、名称为 myproject 的虚拟环境，然后通过 pyenv activate myproject 激活，管理起来更加便捷。

5. 使用deadsnakes PPA：安装旧版本Python

有些情况下，Ubuntu官方软件仓库中并没有你需要的旧版本Python，例如Python 3.7。这时，deadsnakes PPA 就是一个非常常见且可靠的补充来源。它长期维护多个Ubuntu官方仓库未默认提供的Python版本，适合有兼容性需求的开发场景。

• 添加PPA并安装：

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

• 使用虚拟环境：安装完成后，可以直接通过 python3.7 -m venv myenv 创建一个基于Python 3.7的独立虚拟环境，从而与系统中的其他Python版本实现共存，方便项目隔离与版本管理。