Python 虚拟环境入门:用 venv 把项目依赖隔离开
刚学 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 很久不更新,新人按清单装完却跑不起来,改依赖就顺手更新清单。
虚拟环境不是什么高深技术,它只是把“各项目的依赖分开存放”这个朴素想法落到实处。写代码之前先花一分钟建好环境,后面能省下很多排错的时间。
- 点赞
- 收藏
- 关注作者
评论(0)