0

0

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

betcha

betcha

发布时间:2025-09-04 18:48:02

|

482人浏览过

|

来源于php中文网

原创

虚拟环境通过为每个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中:

In3D
In3D

把真人变成化身,创建逼真且可自定义的虚拟角色

下载
.\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
安装的包都只会存在于这个虚拟环境中。如果你想在虚拟环境中使用全局安装的包,那是不行的,你需要重新在虚拟环境里安装一遍。这正是隔离的意义所在,也是它发挥作用的方式。

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

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

169

2026.02.04

Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

169

2026.02.04

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

373

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

437

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

804

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

371

2025.07.23

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1518

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1172

2023.07.27

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.8万人学习

Git 教程
Git 教程

共21课时 | 4.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号