Python 虚拟环境的创建(venv)
虚拟环境是一个独立的 Python 运行空间,拥有自己的解释器、安装包和配置,与系统全局环境完全隔离。
Python 虚拟环境(Virtual Environment)是一个独立的 Python 运行环境,它允许你在同一台机器上为不同的项目创建隔离的 Python 环境。
不同项目可以在各自的虚拟环境中并行运行,互不干扰。
每个虚拟环境都有自己的:
- Python 解释器
- 安装的包/库
- 环境变量
虚拟环境让每个项目拥有独立的依赖空间,彻底消除版本冲突
为什么需要虚拟环境
- 项目隔离:不同项目可使用不同版本的 Python 和第三方库
- 避免污染:安装的包只影响当前环境,不污染全局 Python
- 依赖可控:通过
requirements.txt精确记录和复现环境 - 安全测试:可以放心升级或试用新包,不影响其他项目
场景举例:
- 项目 A 需要 Django 3.2 版本
- 项目 B 需要 Django 4.0 版本
- 如果在系统全局安装,两个版本会冲突
虚拟环境工具
| 工具名称 | 类型 | Python版本支持 | 安装方式 | 特点 | 适用场景 |
|---|---|---|---|---|---|
| venv(推荐) | 内置模块 | ≥ 3.3 | 无需安装,内置 | 轻量级、官方推荐、使用简单 | 通用开发、日常项目 |
| virtualenv | 第三方工具 | 2.x 和 3.x | pip install virtualenv |
功能丰富、兼容多版本 | 需要兼容旧版本或高级功能 |
| conda | Anaconda自带 | 2.x 和 3.x | 随 Anaconda/Miniconda 安装 | 跨语言包管理、数据科学生态 | 数据科学、机器学习项目 |
若需更老版本支持,可使用 virtualenv(Python 2兼容):
pip install virtualenv # 非必须,venv 通常够用
本章节我们将使用 venv 创建和管理虚拟环境。
创建虚拟环境
Python 3.3+ 内置了 venv 模块,无需额外安装。
使用流程
使用流程总览
检查 Python 版本:
python3 --version # 或者 python --version
创建虚拟环境:
# 基本语法 python3 -m venv 环境名称
例如,创建一个名为 .venv 的虚拟环境:
实例
mkdir my_project && cd my_project
# 创建虚拟环境(命名为'.venv'是常见约定)
python3 -m venv .venv
参数说明:
-m venv:使用 venv 模块.venv:虚拟环境的名称(可以自定义)
创建后的目录结构
.venv/ ├── bin/ # 在 Unix/Linux 系统上 │ ├── activate # 激活脚本 │ ├── python # 环境 Python 解释器 │ └── pip # 环境的 pip ├── Scripts/ # 在 Windows 系统上 │ ├── activate # 激活脚本 │ ├── python.exe # 环境 Python 解释器 │ └── pip.exe # 环境的 pip └── Lib/ # 安装的第三方库
激活虚拟环境
激活后,当前终端的 python 和 pip 命令将自动指向该虚拟环境,所有安装操作均在隔离空间内进行。
macOS / Linux
source .venv/bin/activate
Windows(CMD / PowerShell)
.venv\Scripts\activate
激活成功后,命令行提示符通常会显示环境名称:
(.venv) $
验证激活是否生效:
# 查看 Python 路径,应指向 .venv 目录 which python # macOS/Linux where python # Windows → /path/to/my_project/.venv/bin/python
使用虚拟环境
安装包
在激活的环境中,使用 pip 安装的包只会影响当前环境:
pip install package_name
例如:
# 安装单个包(如Django) (.venv) pip install django==3.2.12 # 安装多个包 (.venv) pip install requests pandas # 安装速度慢?使用国内镜像 (.venv) pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple
查看已安装的包
(.venv) pip list Package Version ---------- ------- Django 3.2.12 pip 21.2.4 # 查看某个包的详情 (.venv) pip show django # 升级包 (.venv) pip install --upgrade pip
导出依赖
使用 requirements.txt 记录和复现项目环境,是团队协作的标准做法:
(.venv) pip freeze > requirements.txt
requirements.txt 文件内容示例:
Django==3.2.12 requests==2.26.0 pandas==1.3.3
从文件安装依赖
(.venv) pip install -r requirements.txt
提示:将 .venv/ 加入 .gitignore,只提交 requirements.txt。虚拟环境体积大且路径绑定,不应纳入版本控制。
退出虚拟环境
当完成工作后,可以退出虚拟环境:
deactivate
退出后,命令行提示符会恢复正常,Python 和 pip 命令将使用系统全局版本。
删除虚拟环境
要删除虚拟环境,只需删除对应的目录即可:
# 确保已退出环境 deactivate
删除虚拟环境
虚拟环境本质上是一个普通目录,删除目录即彻底移除:
macOS / Linux
rm -rf .venv
Windows
rmdir /s /q .venv
deactivate 退出环境,否则当前 Shell 会保留失效的环境变量。
实际项目示例
假设开发一个 Django 项目:
实例
mkdir my_site && cd my_site
# 2. 创建虚拟环境并激活
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 3. 安装 Django 并记录依赖
(.venv) pip install django==4.2
(.venv) pip freeze > requirements.txt
# 4. 初始化 Django 项目
(.venv) django-admin startproject config .
# 5. 数据库迁移并启动开发服务器
(.venv) python manage.py migrate
(.venv) python manage.py runserver
# 6. 开发完成,退出环境
(.venv) deactivate
高级用法
指定 Python 版本
如果你安装了多个 Python 版本,可以指定使用哪个版本来创建虚拟环境:
python3.8 -m venv .venv # 使用 Python 3.8
创建不带 pip 的环境
python -m venv --without-pip .venv
创建继承系统包的虚拟环境
python -m venv --system-site-packages .venv
常见问题解答
1. 为什么我的虚拟环境没有 activate 脚本?
确保你使用的是正确的路径:
- Windows:
Scripts\activate - Unix/Linux:
bin/activate
2. 如何知道当前是否在虚拟环境中?
检查命令行提示符是否有环境名称前缀,或运行:
which python
3.安装包速度慢
使用国内镜像源:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
查看 Python 解释器的路径是否在虚拟环境目录中。
4. 虚拟环境可以移动位置吗?
不建议。虚拟环境内的脚本和配置文件中硬编码了绝对路径,移动后会失效。如需迁移,最简单的方式是重新创建环境并通过 requirements.txt 恢复依赖。
5. 虚拟环境会占用多少空间?
空环境约 20–50 MB,随安装的包增多而增加。数据科学项目(NumPy、Pandas、PyTorch)可能达到数 GB。定期清理不再使用的虚拟环境是个好习惯。
最佳实践
- 每个项目独立一个环境:避免不同项目的依赖相互影响
- 统一命名为
.venv:大多数 IDE(VS Code、PyCharm)可自动识别 - 及时更新
requirements.txt:每次pip install后同步导出 - 版本控制中忽略虚拟环境:在
.gitignore中添加.venv/ - 定期清理废弃环境:释放磁盘空间
- 生产环境固定版本号:
requirements.txt中明确写==版本,避免意外升级
# .gitignore 推荐配置 .venv/ __pycache__/ *.pyc .env *.egg-info/