Python虚拟环境virtualenv的安装与使用详解

程一诺
程一诺
发布时间:2026-10-13| 1人浏览过
原创

本文详细介绍Python虚拟环境工具virtualenv的安装与配置方法。涵盖从基础安装、创建指定解释器的虚拟环境,到激活、退出及删除环境的完整操作流程。同时深入讲解virtualenvwrapper的高级管理功能,包括统一目录管理、环境切换及批量操作命令,帮助开发者实现项目依赖的完全隔离与高效管理。

前言

动态语言如Ruby和Python均支持虚拟环境机制。虚拟环境旨在为程序执行提供独立的运行空间,允许在同一台服务器上为不同系统创建多个隔离的虚拟环境,确保各项目运行环境相互独立且互不干扰。例如,项目A可基于Python 2环境运行,而项目B则可基于Python 3环境运行。Python通过virtualenv工具来管理这些虚拟环境。

安装 virtualenv

$ pip install virtualenv

使用方法

$ cd my_project_folder
$ virtualenv venv

执行相关命令后,系统会在当前目录下生成一个文件夹。该文件夹内包含Python执行文件及pip的副本,用于安装其他软件包(packages)。

.
├── bin
│ ├── activate
│ ├── activate.csh
│ ├── activate.fish
│ ├── activate_this.py
│ ├── easy_install
│ ├── easy_install-3.5
│ ├── pip
│ ├── pip3
│ ├── pip3.5
│ ├── python -> python3
│ ├── python3
│ ├── python3.5 -> python3
│ └── wheel
├── include
│ └── python3.5m -> /Library/Frameworks/Python.framework/Versions/3.5/include/python3.5m
└── lib
 └── python3.5

此外,在创建虚拟环境时,可以指定特定的Python解释器。例如,以下命令展示了如何基于Python 3创建虚拟环境:

$ virtualenv -p /usr/local/bin/python3 venv

默认情况下,虚拟环境会继承系统环境中的site packages,即系统中已安装的第三方包也会出现在虚拟环境中。若不希望依赖这些系统包,可在创建时添加参数 --no-site-packages 来建立完全独立的虚拟环境。

virtualenv --no-site-packages [虚拟环境名称]

激活虚拟环境

cd env
source ./bin/activate

激活成功后,命令行提示符前会显示虚拟环境的名称,格式类似((env)Your-Computer:your_project UserName$)。

退出虚拟环境

$ deactivate

若需删除虚拟环境,直接运行rm -rf venv/命令即可。

在虚拟环境安装Python packages

Virtualenv 附带了pip安装工具,因此需要安装的软件包可直接通过以下命令进行安装:

pip install [套件名称]

如果未启动虚拟环境,而系统环境中也安装了pip工具,软件包将被错误地安装在系统环境中。为避免此情况,可在 ~/.bashrc 文件中添加以下配置:

export PIP_REQUIRE_VIRTUALENV=true

如果在未开启虚拟环境时运行pip,系统将提示如下错误:

Could not find an activated virtualenv (required).

Virtualenvwrapper

Virtaulenvwrapper 是 virtualenv 的扩展包,旨在更方便地管理虚拟环境,其主要功能包括:

1. 将所有虚拟环境整合在一个统一的目录下

2. 管理(新增、删除、复制)虚拟环境

3. 切换虚拟环境

4. ...

安装Virtualenvwrapper

在安装Virtualenvwrapper之前,需确保virtualenv已经安装。

$ pip install virtualenvwrapper

此时还不能直接使用virtualenvwrapper,因为默认情况下virtualenvwrapper安装在 /usr/local/bin 目录下。实际上,你需要运行 virtualenvwrapper.sh 文件。请先打开该文件查看,其中包含安装步骤,我们按照指引完成环境设置。

1、创建目录用来存放虚拟环境

mkdir $HOME/Envs

编辑 ~/.zshrc 或 ~/.bashrc 文件(根据你使用的shell类型决定)

添加以下配置: export WORKON_HOME=$HOME/Envs source /usr/local/bin/virtualenvwrapper.sh 3. 运行以下命令使配置生效:

$ source ~/.zshrc

此时virtualenvwrapper即可使用。virtualenvwrapper的基本使用方式如下:

1、列出虚拟环境列表

workon 或者 lsvirtualenv

新建虚拟环境

mkvirtualenv [虚拟环境名称]

2、启动/切换虚拟环境

workon [虚拟环境名称]

3、删除虚拟环境

rmvirtualenv [虚拟环境名称]

4、离开虚拟环境,命令与virutalenv相同

deactivate

总结

以上就是这篇文章的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助。如果有疑问大家可以留言交流,谢谢大家本站的支持。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。