Python版本切换全攻略

本文详细解析了在不同操作系统下灵活切换 Python 版本的核心方法与实操技巧，重点推荐跨平台、安全高效的 pyenv 工具（支持全局、项目级和会话级精准切换），并分别介绍了 macOS 下 Homebrew 的符号链接管理、Linux 中 update-alternatives 的系统级配置，以及 Windows 上 Python Launcher 的便捷版本调用与 PATH 手动优化方案，帮助开发者告别环境冲突，轻松驾驭多版本 Python 开发需求。

切换 Python 版本的核心在于控制终端中 python 或 python3 命令实际指向哪个可执行文件。不同系统和管理方式操作略有差异，下面分场景说明关键方法。

使用 pyenv（推荐，尤其适合开发多版本需求）

pyenv 是专为 Python 版本管理设计的工具，能全局、局部或按 Shell 会话切换版本，不依赖系统包管理器，安全且灵活。

• 安装 pyenv（以 macOS/Linux 为例）：
  curl https://pyenv.run | bash，然后按提示配置 shell 初始化（如添加到 ~/.zshrc）
• 安装指定版本（如 3.9.18 和 3.11.9）：
  pyenv install 3.9.18
  pyenv install 3.11.9
• 切换方式：
  • 全局默认：pyenv global 3.9.18
  • 当前目录生效：pyenv local 3.11.9（会在当前目录生成 .python-version 文件）
  • 仅当前 Shell 会话：pyenv shell 3.10.12
• 验证：python --version 或 which python

macOS 使用 Homebrew 安装多个版本后手动切换

Homebrew 默认安装的 Python 会带版本号（如 python3.9、python3.11），但 python3 符号链接需手动调整。

• 查看已安装版本：brew list | grep python
• 重链接 python3 指向目标版本：
  brew unlink python@3.9 && brew link python@3.11
• 注意：多次执行 brew link 会覆盖之前的链接；也可用 brew switch（旧版 Homebrew 支持，新版已弃用）

Linux（Ubuntu/Debian）使用 update-alternatives

系统级管理命令别名，适合需要统一控制 python、python3 行为的场景。

• 先将各版本注册进 alternatives：
  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
• 交互式切换：sudo update-alternatives --config python3，选择编号即可
• 验证：python3 --version 和 ls -l $(which python3)

Windows 上切换 Python 版本

主要靠修改环境变量 PATH 中 Python 安装目录的顺序，或使用启动器 py。

• 推荐使用 Python Launcher（Windows 官方自带，安装时勾选“Add Python to PATH”通常已启用）：
  • 运行 py -3.9 启动 3.9
  • 运行 py -3.11 启动 3.11
  • 查看所有已注册版本：py -0
• 手动改 PATH：把目标 Python 的安装路径（如 C:\Python311\）移到系统或用户环境变量 PATH 的最前面
• 注意：不要直接删改 python.exe 的原始位置，容易影响其他程序

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。