python pyenv与 pyenv-virtualenv配置

Posted 2021-03-22 keydnal

1、安装 pyenv

说明：本文的所有安装都严格遵守官方文档，与官方文档完全保持一致。

git 地址：https://github.com/pyenv/pyenv

在你的终端中执行如下命令，安全无毒，请放心食用：

首先把项目克隆下来，放在家目录下的隐藏文件夹中：.pyenv

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

然后配置环境变量

如果你使用 bash，就依次执行如下命令：

echo ‘export PYENV_ROOT="$HOME/.pyenv"‘ >> ~/.bashrc

echo ‘export PATH="$PYENV_ROOT/bin:$PATH"‘ >> ~/.bashrc

echo -e ‘if command -v pyenv 1>/dev/null 2>&1; then eval "$(pyenv init -)" fi‘ >> ~/.bashrc

如果你使用 zsh，就依次执行如下命令：

echo ‘export PYENV_ROOT="$HOME/.pyenv"‘ >> ~/.zshrc

echo ‘export PATH="$PYENV_ROOT/bin:$PATH"‘ >> ~/.zshrc

echo -e ‘if command -v pyenv 1>/dev/null 2>&1; then eval "$(pyenv init -)" fi‘ >> ~/.zshrc

echo 命令的含义是：将引号中内容写入某文件中
请注意，以上的三条 echo 命令的最后一条长长的命令，请你保证它引号中的内容处于 ~/.bashrc 或者 ~/.zshrc 的最底部。
因为在 pyenv 初始化期间会操作 path 环境变量，导致不可预测的行为。
查看文件的底部内容，可以使用 tail 命令，用法：tail ~/.bashrc 或者 tail ~/.zshrc，编辑文件可以使用 vim 或者 vscode

最后，在使用 pyenv 之前，重新初始化 shell 环境，执行如下命令

exec $SHELL

不执行该命令也是完全可以的，你可以关闭当前的终端窗口，重新启动一个就可以了。

此时，你已经完成了 pyenv 的安装了，你使用可以它的全部命令了，但是我建议你先别急着用，一口气装完 pyenv 的一个插件，那就是 pyenv-virtualenv

2、安装 pyenv-virtualenv

git 地址：https://github.com/pyenv/pyenv-virtualenv

把插件克隆在刚才已经安装完毕的 pyenv 的 plugins 文件夹中

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

然后配置环境变量

如果你使用 bash，就执行如下命令：

echo ‘eval "$(pyenv virtualenv-init -)"‘ >> ~/.bashrc

如果你使用 zsh，就执行如下命令：

echo ‘eval "$(pyenv virtualenv-init -)"‘ >> ~/.zshrc

最后，在使用 pyenv 之前，重新初始化 shell 环境，执行如下命令

exec $SHELL

3.使用 pyenv

此处仅仅展示 pyenv 和 virtualenv 的日常用法

检查安装是否正确

检查 pyenv 的版本

pyenv version

查看 pyenv 已经托管了哪些 python 版本

pyenv versions

如果你看到了正常的版本信息，就说明可以了，如果看到了类似于 command not found 之类的，就说明安装失败了。

安装 3.8.0 版本的 python

pyenv install 3.8.0

这里有个问题，某些情况下会安装失败，报错就告诉你 Build failed

这个时候，pyenv 已经在它的 github wiki 里面为我们准备了一篇错误应对方案，原文地址 https://github.com/pyenv/pyenv/wiki

大意如下，只需要执行对应的命令即可：

CentOS/Fedora <= 21 用户，请你保证已经安装了 xz 工具

sudo yum install gcc zlib-devel bzip2 bzip2-devel readline-devel sqlite sqlite-devel openssl-devel tk-devel libffi-devel -y

安装完这些补充的工具之后，再次执行：

pyenv install 3.8.0

就可以成功了，你可以不断的使用

pyenv versions

pyenv 托管 python 版本，virtualenv 使用 python 版本

好了，之前已经装好了版本，那么现在就来使用吧

第 1 步：创建虚拟环境

首先需要创建一个虚拟环境，执行命令：

pyenv virtualenv 3.8.0 my-env

第 2 步：激活虚拟环境

在任意目录下，执行命令：

pyenv activate my-env

你会发现，在你的终端里面，多了一个类似于 (my-env) 这样的一个东西，这时候你如果执行：

python --version

那就是 python 3.8.0 了

如果你执行：

pip --version

它会告诉你 pip 包安装的绝对路径，也是 pyenv 安装目录下的某个文件夹

如果你关掉了终端，那么下次启动你又得重新激活一次了，你可以使用如下命令：

首先 cd 到某一个目录，比如 ~/test

cd ~/test

然后在该目录下执行：

pyenv local my-env

你会发现已经被激活了，那么 local 命令和刚才有啥不同呢。如果你执行：

ls -al

你就会发现，在 ~/test 目录下，有个隐藏文件 .python-version，你可以看到这个文件里面，只写了一句话 my-env

这样你只要进入 ~/test 目录，就会自动激活虚拟环境

在虚拟环境下，你如果直接执行

python

就会进入到 python 的交互环境

如果你写了一个文件，名字叫做 app.py ，里面的内容只有一句代码：print(1)

然后执行：

python app.py

这时候，系统就会调用虚拟环境中的 python 解释器来执行这些代码了

更新 pyenv

由于我们是 git 克隆的，所以更新非常简单

cd ~/.pyenv 或者 cd $(pyenv root)
git pull