pyenv-virtualenv 终极使用指南

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' 目录中。

1. 克隆插件到插件目录

   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

2. （可选）添加自动激活功能

   将pyenv virtualenv-init添加到你的 shell 配置中，以启用虚拟环境的自动激活功能。

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

   Zsh 用户：修改你的~/.zshrc文件而不是~/.bashrc。

3. 重启 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

特殊环境变量

你可以设置特定的环境变量来控制 pyenv-virtualenv 的行为：

• PYENV_VIRTUALENV_CACHE_PATH：指定用于缓存下载包文件的目录
• VIRTUALENV_VERSION：强制 pyenv-virtualenv 安装指定版本的 virtualenv
• GET_PIP：当优先使用venv而非virtualenv时，使用指定位置的get_pip.py
• PYENV_VIRTUALENV_PROMPT：允许用户自定义 shell 提示符的显示方式

最佳实践建议

项目环境管理

• 为每个项目创建独立的虚拟环境
• 使用 requirements.txt 文件管理项目依赖
• 在.python-version文件中记录项目使用的 Python 版本

性能优化

• 定期清理不再使用的虚拟环境
• 使用pyenv rehash命令更新环境缓存
• 监控磁盘空间使用情况，及时删除大型环境文件

通过掌握 pyenv-virtualenv 的核心功能，你可以更加高效地管理 Python 开发环境，确保不同项目之间的依赖隔离和版本兼容性。

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