Python 虚拟环境 venv——从创建到依赖管理
刚学 Python 时,很多人都是直接把包一股脑装进系统 Python。项目一多,麻烦就来了:A 项目要 requests 2.x,B 项目要 1.x;升级一个库,另一个项目跟着报错。虚拟环境 venv 就是为了解决这个问题:给每个项目一个独立、干净的 Python 运行环境,互不干扰。
一、venv 是什么
venv 是 Python 3.3 起内置的标准库模块。它会在指定目录里复制一份 Python 解释器和标准库,并创建一个独立的 site-packages。激活后,pip 安装的包只会进入当前环境,不会污染全局 Python。环境目录本身可以随时删除、重建,成本很低。
二、创建虚拟环境
首先确认 Python 版本,建议使用 Python 3.8 及以上:
python --version
python -m venv .venv
第一条命令检查版本,第二条在当前项目目录下创建名为 .venv 的环境。习惯上把环境放在项目根目录,名字统一用 .venv,方便团队协作和工具识别。Windows 上命令是 py -m venv .venv,效果相同。
三、激活与退出
创建后需要激活,激活成功后命令行前面会出现 (.venv) 前缀:
# macOS / Linux
source .venv/bin/activate
# Windows PowerShell
.venv\Scripts\Activate.ps1
# Windows CMD
.venv\Scripts\activate.bat
用完后输入 deactivate 即可退出。需要注意,激活只是改变了当前终端的 PATH,关掉终端环境就失效了;新开终端要重新激活。
四、依赖管理:装、冻、还
激活后先升级 pip,再安装依赖:
python -m pip install --upgrade pip
pip install requests flask
pip freeze > requirements.txt
pip freeze 会把当前环境里所有包及精确版本写入 requirements.txt,这是团队协作的约定:别人拿到项目后,一条命令就能还原出相同的环境:
pip install -r requirements.txt
只装需要的包、及时更新 requirements.txt、定期清理不再用的依赖,是保持环境干净的关键。
五、常见坑与好习惯
第一,不要把 .venv 提交到 Git,在 .gitignore 里加一行 .venv/ 即可。第二,安装包时优先用 python -m pip,避免 pip 指向了别的解释器。第三,环境出问题不要硬修,直接删掉 .venv 重新创建、再按 requirements.txt 安装,往往最快。第四,编辑器里要把解释器选成 .venv 下的 Python,否则代码提示和运行用的还是全局环境。venv 不解决 Python 版本本身的切换问题,需要多版本共存时,可以再配合 pyenv 等工具。
小结
创建、激活、装包、冻结、还原,这五个步骤就是 venv 的日常工作流。养成“一项目一环境”的习惯,项目迁移、协作和部署都会轻松很多,也能少踩很多“在我电脑上能跑”的坑。
- 点赞
- 收藏
- 关注作者
评论(0)