pyenv/pyenv-virtualenv

这是什么？

核心功能

• 01基于 pyenv 已安装的 Python 版本创建虚拟环境。
• 02列出并删除已有的 virtualenv 和 conda 环境。
• 03根据目录中的 .python-version 文件自动激活或停用环境。
• 04可配合 conda、virtualenv 或内置 venv 模块使用。
• 05支持自定义显示当前激活环境的命令行提示符。

适用场景

• 在 macOS 或 Linux 上为每个项目维护独立的 Python 环境。
• 在 shell 中切换目录时自动切换到对应的项目环境。
• 将 conda 环境与 pyenv 安装的 Python 版本统一管理。

快速上手

1. 1

   将 pyenv-virtualenv 克隆到 pyenv 插件目录

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

   可选：在 shell 中添加 pyenv virtualenv-init 以启用虚拟环境自动激活

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

   重启 shell 以启用 pyenv-virtualenv

   exec "$SHELL"
4. 4

   基于 pyenv 管理的 Python 版本创建虚拟环境

   pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

使用前须知

• !仅支持类 UNIX 系统；它是 pyenv 插件，需要先安装 pyenv。
• !依赖 pyenv，因此必须先完成 pyenv 的配置。

标签

常见问题

pyenv-virtualenv 是什么？

pyenv 插件，用于在类 UNIX 系统上创建、列出、激活和删除 Python virtualenv 与 conda 环境。 pyenv-virtualenv 是 pyenv（Python 版本管理工具）的插件，提供虚拟环境的管理命令。使用 `pyenv virtualenv` 可以基于已安装的某个 Python 版本创建虚拟环境，`pyenv virtualenvs` 列出现有环境，`pyenv virtualenv-delete` 则用于删除。创建时的额外参数会转交给底层工具，可以是 conda、virtualenv，或标准库中的 `python -m venv`。

pyenv-virtualenv 可以免费使用吗？用的什么许可证？

pyenv-virtualenv 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

pyenv-virtualenv 还在维护吗？

活跃维护中。pyenv-virtualenv 最近一次提交是在 2026年10月12日。

pyenv-virtualenv 适合用来做什么？

在 macOS 或 Linux 上为每个项目维护独立的 Python 环境。 在 shell 中切换目录时自动切换到对应的项目环境。 将 conda 环境与 pyenv 安装的 Python 版本统一管理。

pyenv-virtualenv 怎么安装和运行？

将 pyenv-virtualenv 克隆到 pyenv 插件目录: git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv 可选：在 shell 中添加 pyenv virtualenv-init 以启用虚拟环境自动激活: echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc 重启 shell 以启用 pyenv-virtualenv: exec "$SHELL" 基于 pyenv 管理的 Python 版本创建虚拟环境: pyenv virtualenv 2.7.10 my-virtual-env-2.7.10

在哪里获取 pyenv-virtualenv？

源代码和安装说明在 GitHub 上：https://github.com/pyenv/pyenv-virtualenv