当前位置：首页 > news >正文

pyenv-virtualenv 终极使用指南

news 2026/5/12 15:08:25

pyenv-virtualenv 终极使用指南

【免费下载链接】pyenv-virtualenva pyenv plugin to manage virtualenv (a.k.a. python-virtualenv)项目地址: https://gitcode.com/gh_mirrors/py/pyenv-virtualenv

pyenv-virtualenv 是一个强大的 pyenv 插件，专门用于管理虚拟环境和 conda 环境，让 Python 开发者在 UNIX 类系统中轻松切换不同项目的 Python 版本和依赖包。

快速安装配置

作为 pyenv 插件安装

这是安装 pyenv-virtualenv 最直接的方法，将最新开发版本安装到$(pyenv root)/plugins/pyenv-virtualenv目录中。

重要提示：如果你将 pyenv 安装到非标准目录，请确保将此仓库克隆到你安装位置的 'plugins' 目录中。

克隆插件到插件目录

git clone https://gitcode.com/gh_mirrors/py/pyenv-virtualenv $(pyenv root)/plugins/pyenv-virtualenv

对于 Fish shell 用户：

git clone https://gitcode.com/gh_mirrors/py/pyenv-virtualenv (pyenv root)/plugins/pyenv-virtualenv

（可选）添加自动激活功能
将pyenv virtualenv-init添加到你的 shell 配置中，以启用虚拟环境的自动激活功能。
```
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
```
Zsh 用户：修改你的~/.zshrc文件而不是~/.bashrc。
重启 shell 启用 pyenv-virtualenv
```
exec "$SHELL"
```

macOS 用户使用 Homebrew 安装

macOS 用户可以使用 Homebrew 包管理器安装 pyenv-virtualenv。

brew install pyenv-virtualenv

或者安装最新的开发版本：

brew install --HEAD pyenv-virtualenv

核心功能详解

创建虚拟环境

使用pyenv virtualenv命令创建虚拟环境，指定 Python 版本和虚拟环境目录名称。

pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

这将基于 Python 2.7.10 在$(pyenv root)/versions目录下创建一个名为my-virtual-env-2.7.10的虚拟环境。

基于当前版本创建虚拟环境

如果只给pyenv virtualenv一个参数，将基于当前 pyenv Python 版本创建虚拟环境。

$ pyenv version 3.4.3 (set by /home/yyuu/.pyenv/version) $ pyenv virtualenv venv34

列出现有虚拟环境

使用pyenv virtualenvs命令查看所有现有的虚拟环境和 conda 环境。

激活虚拟环境

如果你在 shell 配置中配置了eval "$(pyenv virtualenv-init -)"，pyenv-virtualenv将在进入/离开包含.python-version文件的目录时自动激活/停用虚拟环境。

你也可以手动激活和停用虚拟环境：

pyenv activate <name> pyenv deactivate

删除虚拟环境

删除$(pyenv root)/versions和$(pyenv root)/versions/{version}/envs目录中的相应目录即可删除虚拟环境，或者运行：

pyenv uninstall my-virtual-env

高级特性

virtualenv 与 venv

CPython 3.3 及更新版本提供了 venv 模块，这是virtualenv的继任者，默认随 Python 分发。

如果virtualenv命令不可用且python -m venv可用，pyenv-virtualenv将使用python -m venv。

Anaconda 和 Miniconda 支持

你可以使用conda create来管理conda环境，方式与标准的 Anaconda/Miniconda 安装相同。

$ pyenv version miniconda3-3.9.1 (set by /home/yyuu/.pyenv/version) $ conda env list # conda environments: # myenv /home/yyuu/.pyenv/versions/miniconda3-3.9.1/envs/myenv root * /home/yyuu/.pyenv/versions/miniconda3-3.9.1 $ pyenv activate miniconda3-3.9.1/envs/myenv