Mac Python 使用 pyenv 多版本管理

一、pyenv 安装

• Python 官网。

• Python pyenv install 下载安装慢（失败）完美解决。

• 开发过程中，有时候需要经常切换 Python 的版本，或者系统自带的版本不符合自己的开发要求，需要安装其他的版本，此时需要在系统中安装多个 Python 版本，但又不能影响系统自带的 Python，即需要实现 Python 的多版本共存，pyenv 就是这样一个 Python 版本管理器。

• 官方 pyenv Github 包含了 brew 安装方式，也包含了 curl 安装方式：

  • brew 安装方式，附带 Homebrew 安装与卸载：

    # 更新 brew 保证下载到新版本的 pyenv
    $ brew update
    
    # 安装
    $ brew install pyenv
    
    # 卸载
    $ brew uninstall pyenv
    

  • curl 安装方式，直接看 官方 GitHub

  • 注意: 上面两种安装完成之后，还需要配置一下环境变量，Bash、Zsh 解释器不同配置方式不同，推荐看下 官方文档。

  • 添加环境变量到 ~/.zshrc 或者 ~/.bash_profile 中，如果报错 command not found: python，建议看下 官方文档 环境变量配置，调整好即可：

    export PYENV_ROOT="$HOME/.pyenv"
    export PATH="$PYENV_ROOT/bin:$PATH"
    eval "$(pyenv init --path)"
    

  • 刷新一下环境变量使其生效

    # 加了哪个就刷新哪个
    $ source ~/.zshrc
    $ source ~/.bash_profile
    

二、pyenv 使用

• 列出所有可安装版本：

  $ pyenv install -l
  $ pyenv install --list
  

• 列出所有已安装的版本，当前使用版本会用 星号(*)标出：

  $ pyenv version
  $ pyenv versions
  

• 安装指定版本：

  $ pyenv install <version>
  $ pyenv install [-k -v] <version>
  # pyenv install -k -v 3.10.0 -k 是 keep，安装之后会在本地保存下载的源码包，-v是 version，指定为当前 global 版本
  

• 卸载某个版本（-f 或 --force 参数指是否强制卸载，如果强制卸载不会弹出提示，而且如果版本不存在话也不会显示错误信息）：

  $ pyenv uninstall [-f|--force] <version>
  

• 改变全局 Python版本：

  $ pyenv global 3.10.2
  

• 改变当前目录 Python 版本：

  $ pyenv local 3.10.2
  

• 取消当前目录版本改变：

  $ pyenv local --unset
  

• 查看当前将使用的版本（可以用来核对版本是否切换成功）：

  $ python -V
  

• 指定当前 Shell 使用的 Python 版本

  pyenv shell 3.10.2
  

• 取消当前 Shell 使用的 Python 版本

  $ pyenv shell --unset
  

• 如果出现什么小问题或者没生效的情况，可以尝试刷新一下：

  $ pyenv rehash