Python / 系统课时
用 venv 隔离项目依赖
用 venv 隔离项目依赖
本篇解决 Python 项目之间依赖冲突的问题,通过创建虚拟环境让每个项目拥有独立的解释器和第三方库目录。完成学习后,你可以创建、激活、安装依赖并验证隔离效果。
学习目标
- 理解虚拟环境解决依赖隔离问题的机制
- 掌握使用 venv 创建和管理项目环境的方法
- 学会验证虚拟环境是否生效并避免常见依赖错误
为什么需要虚拟环境
Python 项目通常会依赖不同版本的第三方库。如果所有项目共用系统 Python 环境,一个项目升级依赖可能影响其他项目,导致运行结果不可预测。
虚拟环境通过创建独立目录保存解释器相关文件和安装的包,让项目之间互不干扰。开发时通常一个项目对应一个虚拟环境,并使用依赖文件记录安装内容。
创建和激活 venv 环境
Python 内置的 venv 模块可以快速创建虚拟环境。下面以一个命令行项目目录为例。
bash
mkdir demo-project
cd demo-project
python -m venv .venv
# Linux 或 macOS 激活环境
source .venv/bin/activate
# Windows PowerShell 激活环境
# .venv\Scripts\Activate.ps1
python -m pip install requests预期输出
text
Successfully installed requests激活后执行的 python 和 pip 会优先使用虚拟环境中的版本。.venv 是常见目录名,也可以根据项目规范使用其他名称。
验证环境是否隔离
创建环境后,需要确认当前解释器路径已经切换到虚拟环境,而不是系统 Python。
bash
python -c "import sys; print(sys.executable)"
python -m pip show requests预期输出
text
<项目路径>/.venv/bin/python
Name: requests
Version: <INSTALLED_VERSION>其中 <INSTALLED_VERSION> 表示实际安装版本,不同时间安装结果可能不同。
管理项目依赖
虚拟环境本身通常不提交到代码仓库,而是通过依赖文件恢复环境。
bash
python -m pip freeze > requirements.txt预期结果
text
生成 requirements.txt 文件,记录当前环境中的第三方依赖版本。其他开发者拉取项目后,可以创建新的虚拟环境并安装这些依赖:
bash
python -m pip install -r requirements.txt预期结果
text
requirements.txt 中列出的依赖被安装到当前虚拟环境。使用 venv 时的常见问题
如果安装包后运行程序仍提示找不到模块,优先检查当前终端是否已经激活虚拟环境。多个终端窗口可能处于不同环境状态,需要分别激活。
在自动化部署或脚本执行场景中,也可以直接调用虚拟环境中的解释器,例如 <PATH>/.venv/bin/python,避免依赖当前 Shell 的激活状态。虚拟环境适合绝大多数单机 Python 项目;复杂依赖管理场景可以再结合项目工具进行管理。
按自己的节奏,确认真正理解。