【Python】如何在Ubuntu环境中切换Python版本
WSLUbuntu20.04/22.04默认Python3.8,无法满足PrivateGPT等对3.11的需求。需添加deadsnakesPPA源安装Python3.11,并用update-alternatives设为默认。注意切换可能影响系统工具,建议使用虚拟环境隔离。
在部署 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 来建立独立环境了。

Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具,像本地磁盘一样使用网盘。清理链路的完整性会更好一些,做应用卸载、残留处理和空间整理时,通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件,支持OCR公式识别和多平台编辑。和使用说明,避免使用,享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时,它能把识别后的处理步骤接得更顺,资料录入这类场景会省下不少时间。
一款文字处理软件,一种订阅式的跨平台办公软件,基于云平台提供多种服务,通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合,Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件,为私密数据添加多重保护。高频操作更强调就近处理,浏览、整理和跨目录移动文件时,来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具,通过键入缩写自动展开为自定义文段,提升工作效率。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。


























