什么是虚拟环境？为何要用 virtualenv 或 venv？-Python教程-PHP中文网

什么是虚拟环境？为何要用 virtualenv 或 venv？

betcha

发布： 2025-09-04 18:48:02

原创

433人浏览过

虚拟环境通过为每个Python项目创建独立的依赖空间，解决了不同项目间库版本冲突的问题。它隔离了Python解释器和第三方库，确保项目依赖互不干扰，避免全局环境被“污染”。使用venv（Python 3.3+内置）或virtualenv可创建虚拟环境，激活后所有包安装仅限该环境。常见实践包括：将虚拟环境目录加入.gitignore、用pip freeze > requirements.txt锁定依赖、每个项目独立建环境。高效使用虚拟环境能显著提升开发效率与项目可维护性。

什么是虚拟环境？为何要用 virtualenv 或 venv？

虚拟环境，简单来说，就是Python项目的一个独立工作空间。它能让每个项目拥有自己专属的Python解释器和一套依赖库，互不干扰。我们之所以要用

virtualenv

登录后复制

或

venv

登录后复制

，核心原因就是为了避免不同项目间因依赖库版本冲突而导致的“依赖地狱”问题，同时保持系统全局Python环境的干净整洁。

Python项目开发中，最让人头疼的莫过于依赖管理了。你可能手上有好几个项目，比如一个老旧的Django 2.2项目，它依赖

django-rest-framework==3.9

登录后复制

；而另一个新项目则用的是Django 3.2，需要

django-rest-framework==3.12

登录后复制

。如果所有这些依赖都直接安装在系统的全局Python环境里，那么当你尝试更新其中一个库时，很可能就会破坏掉另一个项目的运行。这就像是你在同一个房间里同时进行两项需要不同工具箱的工作，工具混在一起，最终只会一团糟。虚拟环境的出现，就是为了解决这个痛点。它为每个项目创建了一个“沙盒”，每个沙盒里都有独立的Python解释器和

site-packages

登录后复制

目录，项目所需的任何库都安装在这个沙盒里，完全不影响系统或其他项目的环境。这样一来，你就可以放心地为每个项目安装它所需要的特定版本库，而不用担心会波及无辜。

Python项目依赖管理中的痛点与虚拟环境的解法

回想一下，如果你没有使用虚拟环境，当你需要为项目A安装

requests

登录后复制

库的某个特定版本时，你可能会直接

pip install requests==X.Y.Z

登录后复制

。如果你的系统里已经有另一个项目B依赖了

requests

登录后复制

的另一个版本，那么这次安装很可能会覆盖掉旧版本，导致项目B无法正常运行。这种场景在我刚接触Python的时候简直是家常便饭，每次新开一个项目，都要小心翼翼地检查现有环境，生怕一个不小心就“污染”了。

虚拟环境的解法非常优雅。它实际上是在你的项目目录下创建了一个独立的Python环境副本。这个副本包含了自己的Python解释器、pip工具以及一个空的

site-packages

登录后复制

目录。当你激活这个虚拟环境后，所有通过

pip

登录后复制

安装的包都只会安装到这个环境的

site-packages

登录后复制

目录中，与系统的全局环境彻底隔离。

举个例子，假设你有一个名为

project_alpha

登录后复制

的项目，需要

numpy==1.20.0

登录后复制

。你在这个项目的目录下创建一个虚拟环境并激活它，然后

pip install numpy==1.20.0

登录后复制

。接着，你又有一个

project_beta

登录后复制

，它需要

numpy==1.24.0

登录后复制

。你为

project_beta

登录后复制

创建并激活另一个虚拟环境，然后

pip install numpy==1.24.0

登录后复制

。这两个项目现在可以各自独立运行，互不干扰，即使它们依赖同一个库的不同版本。这种隔离性，不仅解决了版本冲突，也让项目的依赖管理变得异常清晰，你随时可以通过

pip freeze > requirements.txt

登录后复制

导出当前环境的所有依赖，方便团队协作和部署。

如何创建和激活虚拟环境？venv与virtualenv有何异同？

创建和激活虚拟环境是日常开发中非常基础但又极其重要的操作。Python 3.3及以上版本已经内置了

venv

登录后复制

模块，所以我们通常会优先使用它，因为它省去了额外安装的步骤，用起来也更轻量。

要创建一个虚拟环境，你只需要在项目根目录下运行：

python3 -m venv my_project_env

登录后复制

这里的

my_project_env

登录后复制

是你给虚拟环境起的名字，通常我会习惯性地命名为

.venv

登录后复制

或

venv

登录后复制

，然后把它添加到

.gitignore

登录后复制

文件里，避免提交到版本控制。

创建之后，你需要激活它才能让你的终端会话使用这个隔离的环境。在类Unix系统（Linux/macOS）上：

source my_project_env/bin/activate

登录后复制

在Windows的PowerShell中：

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ ...

查看详情

.\my_project_env\Scripts\Activate.ps1

登录后复制

在Windows的命令提示符（Cmd）中：

my_project_env\Scripts\activate.bat

登录后复制

激活后，你的终端提示符通常会显示虚拟环境的名称（比如

(my_project_env)

登录后复制

），这表明你当前的操作都在这个独立的环境中进行。当你完成工作，或者想切换到另一个项目时，只需要输入

deactivate

登录后复制

就可以退出当前虚拟环境，回到系统的全局环境。

至于

virtualenv

登录后复制

，它是一个第三方库，在

venv

登录后复制

模块出现之前，它是创建虚拟环境的标准工具。你可以通过

pip install virtualenv

登录后复制

来安装它，然后用

virtualenv my_project_env

登录后复制

来创建环境。

virtualenv

登录后复制

相比

venv

登录后复制

，在某些方面提供了更多的配置选项，比如支持更老的Python版本，或者在某些特殊场景下能更好地处理系统Python的路径问题。不过，对于大多数现代Python项目而言，

venv

登录后复制

已经足够强大且方便，因为它内置于Python，省去了额外的安装步骤，也更推荐作为首选。可以说，

venv

登录后复制

是

virtualenv

登录后复制

的一个轻量级、内置的替代品。在我看来，除非你有特殊需求，否则直接用

venv

登录后复制

就行了，简单省心。

虚拟环境使用中的常见误区与高效实践策略

尽管虚拟环境的概念并不复杂，但在实际使用中，我见过不少新手甚至一些有经验的开发者也会犯一些小错误，或者没有充分利用其带来的便利。

一个常见的误区就是忘记激活虚拟环境。有时候，我们可能在项目目录下创建了虚拟环境，但却直接运行

pip install some-package

登录后复制

，结果发现包被安装到了全局环境，或者根本找不到。要避免这个，养成习惯在进入项目目录后，第一件事就是

source venv/bin/activate

登录后复制

。一个简单的检查方法是，激活后运行

which python

登录后复制

（Linux/macOS）或

where python

登录后复制

（Windows），看看它指向的是不是你虚拟环境里的Python解释器路径。

另一个误区是混淆全局和虚拟环境的包。激活虚拟环境后，所有通过

pip

登录后复制

安装的包都只会存在于这个虚拟环境中。如果你想在虚拟环境中使用全局安装的包，那是不行的，你需要重新在虚拟环境里安装一遍。这正是隔离的意义所在，也是它发挥作用的方式。

高效实践策略方面，我个人有几点体会：

将虚拟环境目录添加到
.gitignore
登录后复制
：虚拟环境通常很大，包含了解释器和所有依赖库的副本。这些文件不应该被提交到版本控制系统。在你的项目根目录下的
```
.gitignore
```
登录后复制
文件中添加
```
venv/
```
登录后复制
或
```
.venv/
```
登录后复制
是一个好习惯。
始终使用
requirements.txt
登录后复制
进行依赖管理：当你在虚拟环境中安装了所有项目所需的库后，立即运行
```
pip freeze > requirements.txt
```
登录后复制
将当前环境的所有依赖及其精确版本记录下来。这样，无论是团队成员还是部署到服务器，其他人只需要
```
pip install -r requirements.txt
```
登录后复制
就能快速重建一个完全相同的开发环境，大大减少了“在我机器上能跑”的尴尬。
为每个项目创建独立的虚拟环境： 这听起来是基本原则，但有时候一些开发者为了省事，会尝试在多个项目之间共用一个虚拟环境。这几乎总是会带来新的依赖冲突问题，因为不同项目总会有不同的需求。保持一项目一环境的原则，虽然会多占用一些磁盘空间，但长远来看能省去无数麻烦。
考虑更高级的工具（按需）： 对于更复杂的项目，或者当你需要更精细地控制依赖图时，
```
pip-tools
```
登录后复制
(用于自动管理
```
requirements.txt
```
登录后复制
的生成和更新) 或
```
Poetry
```
登录后复制
/
```
Rye
```
登录后复制
(集成了虚拟环境管理、依赖解析、打包发布等功能) 这样的工具可能会派上用场。但即使使用这些工具，它们底层也常常是基于
```
venv
```
登录后复制
或
```
virtualenv
```
登录后复制
的概念。它们是在虚拟环境基础上提供更高层次的抽象和便利。

总的来说，虚拟环境是Python开发中一个不可或缺的工具。它可能不是最华丽的技术，但绝对是最实用、最能提升开发效率和项目稳定性的基石之一。学会正确地使用它，能够让你在Python项目的海洋中游刃有余。

以上就是什么是虚拟环境？为何要用 virtualenv 或 venv？的详细内容，更多请关注php中文网其它相关文章！