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 项目;复杂依赖管理场景可以再结合项目工具进行管理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 venv 隔离项目依赖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通