如何切换python版本

11次阅读

切换 python 版本的核心是控制 python 或 python3 命令指向的可执行文件,推荐使用 pyenv(支持全局、局部及会话级切换),其次 macOS 可用 Homebrew 手动重链接、linux 可用 update-alternatives 系统管理、windows 推荐 Python Launcher。

如何切换python版本

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

使用 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 –versionwhich python

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

Homebrew 默认安装的 Python 会带版本号(如 python3.9python3.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

系统级管理命令别名,适合需要统一控制 pythonpython3 行为的场景。

立即学习Python免费学习笔记(深入)”;

  • 先将各版本注册进 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 –versionls -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 的原始位置,容易影响其他程序
text=ZqhQzanResources