Python 虚拟环境入门:用 venv 把项目依赖隔离开

举报
yd_291742659 发表于 2026/11/14 06:12:23 2026/11/14
【摘要】 刚学 Python 的时候,我几乎把所有包都装在全局环境里。做第一个练手项目装了 requests,做第二个项目又装了新版本,结果第一个项目直接跑不起来。那次之后,我养成了习惯:每个项目一个虚拟环境。 一、虚拟环境是什么虚拟环境就是给某个项目单独准备的一套 Python 解释器和依赖目录。它和系统 Python 隔离开,项目 A 用 requests 2.28,项目 B 用 requests...

刚学 Python 的时候,我几乎把所有包都装在全局环境里。做第一个练手项目装了 requests,做第二个项目又装了新版本,结果第一个项目直接跑不起来。那次之后,我养成了习惯:每个项目一个虚拟环境。

一、虚拟环境是什么

虚拟环境就是给某个项目单独准备的一套 Python 解释器和依赖目录。它和系统 Python 隔离开,项目 A 用 requests 2.28,项目 B 用 requests 2.32,互不干扰。换电脑、换同事接手时,也能按同一份依赖清单还原环境。

二、创建并激活

Python 3.3 以后自带 venv,不用再装第三方工具。进入项目目录后执行:

python -m venv .venv

Windows 激活:

.venv\Scripts\activate

macOS 或 Linux 激活:

source .venv/bin/activate

激活成功后,命令行前面会出现 (.venv),表示当前终端已经进入该环境。此后 pip install 安装的包只会进这个环境,不会污染全局。

三、安装依赖并记录下来

激活后照常安装,比如:

pip install requests

项目依赖要及时固化成清单:

pip freeze > requirements.txt

别人拿到项目后,只要创建环境再执行 pip install -r requirements.txt,就能得到基本一致的依赖版本。这是团队协作里最省事的一步。

四、退出与删除

用完输入 deactivate 就能退出环境。虚拟环境本质上就是一个文件夹,不想要了,直接删除 .venv 目录即可,系统 Python 不受影响。注意不要把 .venv 提交到代码仓库,在 .gitignore 里加一行 .venv 就行。

五、新手容易踩的坑

第一,创建环境后忘记激活,直接在全局装包,等于白建环境。第二,在 IDE 里新建项目时选错了解释器,代码跑的还是系统 Python,检查一下解释器路径是否指向 .venv。第三,requirements.txt 很久不更新,新人按清单装完却跑不起来,改依赖就顺手更新清单。

虚拟环境不是什么高深技术,它只是把“各项目的依赖分开存放”这个朴素想法落到实处。写代码之前先花一分钟建好环境,后面能省下很多排错的时间。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。