Mac 安装和管理多个 Python 版本

背景

在 MacOS 10.15 Catalina 即将公测之际，国外技术论坛发表了一篇名为《macOS 10.15 Catalina弃用UNIX脚本语言》的帖子，其中说到：较旧的 Python 语言版本 2.7 在 MacOS 10.15 Catalina 中已被弃用，不会包含在 MacOS 10.16 中。其他UNIX脚本语言（Ruby & Perl）也是如此。

然后在 MacOS 10.14 以及之前的版本，都是内置的 Python2 版本。在此笔者也建议 Python 学习者直接学 Python3 。

对于在 Mac 上，学习 Python 的同学来说，避免不了安装双版本 Python 以及切换 Python 版本的情况。那么应该如何有效快速的切换呢？很多同学一定会想到修改环境变量，指定 Python 的默认路径，这样当然可以解决问题，但是不够优雅，不够简洁，不够快速。此时，pyenv 应运而生，它一个 Python 版本管理工具，它可以改变全局的 Python 版本，安装多个版本的 Python，设置目录级别的 Python 版本，还能创建和管理 Python虚拟环境（virtual python environments ）。

PS：笔者体验了一下 MacOS 10.15 内测版，确实一堆 BUG ，不建议升级。

安装 & 使用

1、安装 Homebrew

官网地址：brew.sh/ 获取安装指令，进行安装：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Homebrew安装成功后，会自动创建目录 /usr/local/Cellar 来存放Homebrew安装的程序

PS：Homebrew 是 MacOS 下必装工具之一，是一个非常高效的命令行软件包管理器

2、安装 pyenv

brew update
brew install pyenv
pyenv -v # 安装之后查看 pyenv 版本，确认是否安装成功

3、安装 & 管理多个 Python

pyenv install 2.7.15
pyenv install 3.7.3
pyenv versions # 所有已经安装的版本

注意：在 MacOS 10.14 中，可能出现以下错误：

zipimport.ZipImportError: can't decompress data; zlib not available
make: *** [install] Error 1

原因：

详情参考：问题追查分析

解决方案：

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /
# 此时再安装试试
pyenv install 3.7.3
# 查看所有已经安装的版本，注：星号指定当前的版本
pyenv versions

PS：默认安装路径：~/.pyenv/shims/python

4、常用的命令

使用方式: pyenv <命令> [<参数>]

命令:
  commands    查看所有命令
  local       设置或显示本地的 Python 版本（当前目录及其子目录）
  global      设置或显示全局 Python 版本
  shell       设置或显示 shell 指定的 Python 版本（本次会话）
  install     安装指定 Python 版本
  uninstall   卸载指定 Python 版本)
  version     显示当前的 Python 版本及其本地路径
  versions    查看所有已经安装的版本
  which       显示安装路径

切换版本

pyenv global 3.7.3 # 不建议全局切换
python -V  # 验证一下是否切换成功
pyevn global system  # 切换回系统版本
pyenv local 3.7.3  # 当前目录及其目录切换
python -V  # 验证一下是否切换成功
pyenv local --unset  # 解除local设置
pyenv shell 3.7.3  # 当前shell会话切换
python -V  # 验证一下是否切换成功
pyenv shell --unset  # 解除shell设置

切换不成功

如果遇到切换之后，Python版本还是系统的默认版本的话，就需要配置一下环境变量，在 ~/.zshrc 或 ~/.bash_profile 文件最后写入：

export PYENV_ROOT=~/.pyenv
export PATH=$PYENV_ROOT/shims:$PATH
if which pyenv > /dev/null;
  then eval "$(pyenv init -)";
fi

使配置生效

source ~/.zshrc
# or
source ~/.bash_profile

PS：使用 pyenv 结合虚拟环境则会更加强大，笔者强烈推荐使用。

拓展：pyenv-virtualenv 的安装和使用

pyenv-virtualenv 是一款 pyenv 插件，可以用来搭建基于不同 Python 版本、虚拟且独立的 python 环境，可以使每个项目环境与其他项目独立开来，保持环境的干净，解决包冲突问题。

安装

brew update
brew install pyenv-virtualenv

配置文件

在 ~/.zshrc 或 ~/.bash_profile 文件最后写入：

# pyenv-virtualenv
if which pyenv-virtualenv-init > /dev/null;
  then eval "$(pyenv virtualenv-init -)";
fi

使生效

source ~/.zshrc
# or
source ~/.bash_profile

使用

1、创建 virtualenv

使用当前版本创建 virtualenv

# 当前版本为 2.7.15
pyenv virtualenv xxx-2.5.15

指定版本创建 virtualenv

#pyenv virtualenv 版本号 虚拟环境名
pyenv virtualenv 3.7.3 test-3.7.3

2、查看已创建的virtualenv

pyenv versions

3、激活和停用 virtualenv

手动激活 & 停用：

# 激活
pyenv activate test-3.7.3
# 停用
pyenv deactivate

自动激活：

# 方式一：
# 手动把`虚拟环境名`写入当前目录的.python-version文件中
vim .python-version
# 启动自动激活
pyenv activate test-3.7.3
# 停用自动激活
pyenv deactivate

# 方式二（推荐）：
# 使用 pyenv local 虚拟环境名 （会自动将虚拟环境名写入到当前目录的.python-version文件中）
pyenv local test-3.7.3
# 停用并取消自定激活
pyenv local --unset

4、删除现有virtualenv

pyenv uninstall test-3.7.3 # 使用 pyenv uninstall 虚拟环境名
y # 输入 y ，然后回车