【Python】如何在Ubuntu环境中切换Python版本

在部署 PrivateGPT 项目时，一个常见的坑就是：它要求 Python 3.11 及以上版本。但如果你在 Windows 上通过 WSL 安装了 Ubuntu 20.04 或 22.04，然后兴冲冲地跑一句 python3 --version，结果大概率会看到——3.8。没错，系统默认的 Python 版本还停留在三年前。就算你手动装了 3.11，系统依然会优先调用那个老旧的 3.8。这就导致很多依赖新版特性的工具直接报错，让人一头雾水。

所以，核心问题就一个：如何把 WSL 里的默认 python3 从 3.8 切换到 3.11？下面直接上操作。

【背景】

在 Windows 的 WSL（Ubuntu 20.04/22.04）环境中，系统预装的 Python 版本是 3.8。而 PrivateGPT 这类项目要求至少 Python 3.11，因此必须手动升级并设置默认版本。注意，仅仅安装新版 Python 是不够的，系统仍然会优先使用旧版，关键在于切换默认指向。

【安装 Python 3.11】

第一步，添加官方维护的新版 Python PPA 源——deadsnakes。这个仓库提供了几乎所有主流 Python 版本的安装包，是社区最常用的来源。运行以下命令添加源：

sudo add-apt-repository ppa:deadsnakes/ppa

然后更新软件包列表，并安装 Python 3.11：

sudo apt update
sudo apt install python3.11

安装完成后，验证一下：

python3.11 --version

如果输出版本号，说明安装成功。但这只是第一步，因为系统默认的 python3 仍然指向 3.8。

【切换默认 Python 版本】

WSL 中的 Ubuntu 通常使用 update-alternatives 来管理多个 Python 版本。如果系统中没有配置过，需要先把它注册进去：

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2

这里数字 1 和 2 代表优先级，数字越大优先级越高。然后通过交互命令选择默认版本：

sudo update-alternatives --config python3

系统会列出所有已注册的 Python 版本，输入对应数字选择 3.11 即可。之后再次执行 python3 --version，应该就能看到 3.11 了。

【常见问题与注意事项】

有时切换后，某些依赖旧版 Python 的工具（如 apt 本身）可能会报错，因为 Ubuntu 的很多系统工具硬编码了 python3 指向 3.8。这种情况下，建议不要直接修改系统默认的 python3，而是通过虚拟环境（如 venv、conda）来隔离项目环境。不过如果你只是运行 PrivateGPT 这类独立项目，切换默认版本通常没问题。如果遇到与系统工具冲突，可以保留系统默认的 3.8，只在需要时使用 python3.11 命令或创建虚拟环境。

另外，安装 python3.11-venv 以便创建虚拟环境：

sudo apt install python3.11-venv

然后就可以用 python3.11 -m venv myenv 来建立独立环境了。