Python虚拟环境是开发中解决项目依赖冲突的重要工具,它能为每个项目创建独立的运行环境,避免不同项目的依赖版本互相影响。无论是开发新项目还是维护旧项目,合理使用虚拟环境都能减少很多不必要的麻烦。

为什么需要Python虚拟环境
当我们在全局Python环境中安装第三方库时,所有项目都会共享这些库。假设项目A需要requests==2.20.0,项目B需要requests==3.0.0,全局安装只能保留一个版本,就会导致其中一个项目运行出错。虚拟环境的作用就是为每个项目单独划分空间,每个空间内的依赖互不影响。
使用venv模块创建虚拟环境
Python3.3及以上版本内置了venv模块,无需额外安装就能创建虚拟环境,这是官方推荐的基础方案。
创建虚拟环境
打开终端,进入项目根目录,执行以下命令:
# 创建名为venv的虚拟环境,名称可以自定义 python -m venv venv
执行完成后,项目目录下会生成一个venv文件夹,里面包含独立的Python解释器、pip工具和依赖安装目录。
激活虚拟环境
不同操作系统的激活命令不同:
- Windows系统(CMD终端):
venvScriptsactivate
- Windows系统(PowerShell终端):
.venvScriptsActivate.ps1
- macOS/Linux系统:
source venv/bin/activate
激活成功后,终端提示符前会出现(venv)标识,说明当前已经处于虚拟环境中,后续执行的pip命令都会将依赖安装到这个独立环境里。
退出虚拟环境
如果需要退出当前虚拟环境,执行以下命令即可:
deactivate
虚拟环境中管理项目依赖
安装依赖
激活虚拟环境后,就可以用pip安装项目需要的依赖,比如安装requests库:
pip install requests==2.28.0
此时requests只会安装在当前虚拟环境中,不会影响全局环境和其他虚拟环境。
导出依赖列表
当项目开发完成或者需要迁移时,可以导出当前环境的所有依赖,方便其他人快速搭建相同的环境:
pip freeze > requirements.txt
执行后会在项目目录生成requirements.txt文件,内容类似:
requests==2.28.0 urllib3==1.26.12
从依赖列表安装
其他人拿到项目后,先创建并激活虚拟环境,再执行以下命令就能一键安装所有依赖:
pip install -r requirements.txt
虚拟环境使用注意事项
- 虚拟环境文件夹(比如
venv)不需要提交到代码仓库,一般会在.gitignore文件中添加对应的忽略规则,避免占用仓库空间。 - 如果删除虚拟环境,直接删除对应的
venv文件夹即可,不会影响项目本身的代码。 - 如果系统同时安装了Python2和Python3,创建虚拟环境时需要指定对应的Python版本,比如用
python3 -m venv venv创建Python3的虚拟环境。
简单示例:用虚拟环境运行项目
假设我们有一个简单的Python脚本,需要用到flask库:
# app.py
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return 'Hello World'
if __name__ == '__main__':
app.run(debug=True)
按照以下步骤运行:
- 创建虚拟环境:
python -m venv venv - 激活虚拟环境
- 安装依赖:
pip install flask==2.2.5 - 运行脚本:
python app.py
此时项目运行所需的flask库只存在于当前虚拟环境中,不会和其他项目的flask版本产生冲突。