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 ，不建议升级。

安装 & 使用

一、安装 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 下必装工具之一，是一个很是高效的命令行软件包管理器

二、安装 pyenv

brew update
brew install pyenv
pyenv -v # 安装以后查看 pyenv 版本，确认是否安装成功
复制代码

三、安装 & 管理多个 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

四、经常使用的命令

使用方式: 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
复制代码

使用

一、建立 virtualenv

使用当前版本建立 virtualenv

# 当前版本为 2.7.15
pyenv virtualenv xxx-2.5.15
复制代码

指定版本建立 virtualenv

#pyenv virtualenv 版本号 虚拟环境名
pyenv virtualenv 3.7.3 test-3.7.3
复制代码

二、查看已建立的virtualenv

pyenv versions
复制代码

三、激活和停用 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
复制代码

四、删除现有virtualenv

pyenv uninstall test-3.7.3 # 使用 pyenv uninstall 虚拟环境名
y # 输入 y ，而后回车
复制代码