Python虚拟环境(venv)创建详解

1. 概述

虚拟环境（Virtual Environment）是Python开发中的一项重要技术，它允许为每个项目创建独立的Python运行环境，从而隔离不同项目的依赖包。

1.1 为什么需要虚拟环境

在实际开发中，不同项目可能需要：

不同版本的Python解释器
不同版本的第三方库
避免依赖包之间的冲突

使用虚拟环境可以解决以下问题：

版本冲突：项目A需要Django 3.x，项目B需要Django 4.x
依赖污染：避免全局安装过多包导致环境混乱
可移植性：确保项目在不同机器上具有相同的运行环境
安全性：避免全局安装不受信任的包

1.2 Python虚拟环境工具

Python提供了多种虚拟环境工具：

venv：Python 3.3+内置的虚拟环境模块（推荐）
virtualenv：第三方虚拟环境工具，支持Python 2和3
conda：Anaconda发行版的环境管理工具

本文主要介绍Python内置的venv模块。

2. venv模块简介

venv是Python 3.3+标准库中内置的虚拟环境创建和管理模块，无需额外安装。

2.1 venv的特点

内置模块：无需额外安装
轻量级：仅包含必要的文件和目录
隔离性：每个虚拟环境独立，不会影响全局Python环境
跨平台：支持Windows、Linux、macOS
灵活性：可以选择是否复制全局站点包

2.2 venv的工作原理

venv通过以下方式创建隔离环境：

创建一个独立的目录结构
复制或链接Python解释器
创建空的site-packages目录
配置环境变量（PATH等）

3. 虚拟环境的创建

3.1 基本语法

# 基本语法
python -m venv <虚拟环境名称>

# 示例：创建名为venv的虚拟环境
python -m venv venv

3.2 常用参数

venv模块支持以下常用参数：

参数	描述
`-h, --help`	显示帮助信息
`-v, --verbose`	显示详细输出
`-p PYTHON_EXE, --python=PYTHON_EXE`	指定Python解释器路径
`--system-site-packages`	复制全局站点包到虚拟环境
`--symlinks`	使用符号链接（Unix系统）
`--copies`	复制文件而不是使用符号链接
`--clear`	创建前清理现有目录
`--upgrade`	升级虚拟环境
`--without-pip`	创建时不安装pip
`--prompt PROMPT`	指定虚拟环境的命令提示符前缀

3.3 不同平台的创建示例

3.3.1 Windows平台

# 使用默认Python版本创建虚拟环境
python -m venv myenv

# 使用特定Python版本创建虚拟环境
python3.10 -m venv myenv

# 创建时包含全局站点包
python -m venv myenv --system-site-packages

# 创建时指定提示符
python -m venv myenv --prompt "myproject"

3.3.2 Linux/macOS平台

# 使用默认Python版本创建虚拟环境
python3 -m venv myenv

# 使用特定Python版本创建虚拟环境
python3.9 -m venv myenv

# 创建时包含全局站点包
python3 -m venv myenv --system-site-packages

# 创建时使用符号链接
python3 -m venv myenv --symlinks

3.4 虚拟环境的目录结构

创建虚拟环境后，会生成以下目录结构：

myenv/            # 虚拟环境目录
├── Include/      # C头文件目录
├── Lib/          # Python库目录
│   └── site-packages/  # 虚拟环境的包安装目录
├── Scripts/      # 可执行脚本目录（Windows）
│   ├── activate      # 激活脚本
│   ├── activate.bat  # Windows命令行激活脚本
│   ├── activate.ps1  # Windows PowerShell激活脚本
│   └── python.exe    # 虚拟环境的Python解释器
├── bin/          # 可执行脚本目录（Linux/macOS）
│   ├── activate      # 激活脚本
│   └── python        # 虚拟环境的Python解释器
└── pyvenv.cfg    # 虚拟环境配置文件

4. 虚拟环境的激活

创建虚拟环境后，需要激活它才能使用。激活虚拟环境会修改当前终端的环境变量，使python和pip命令指向虚拟环境中的版本。

4.1 Windows平台

4.1.1 Windows命令行（cmd.exe）

# 激活虚拟环境
venv\Scripts\activate.bat

# 退出虚拟环境
deactivate

4.1.2 Windows PowerShell

# 激活虚拟环境
venv\Scripts\Activate.ps1

# 退出虚拟环境
deactivate

注意：在PowerShell中，可能需要先设置执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

4.1.3 Windows Git Bash

# 激活虚拟环境
source venv/Scripts/activate

# 退出虚拟环境
deactivate

4.2 Linux/macOS平台

# 激活虚拟环境
source venv/bin/activate

# 或更简洁的方式
. venv/bin/activate

# 退出虚拟环境
deactivate

4.3 激活后的变化

激活虚拟环境后：

终端提示符前会显示虚拟环境名称

(venv) C:\Users\User\project>  # Windows
(venv) user@localhost:~/project$  # Linux/macOS

python和pip命令指向虚拟环境中的版本

(venv) $ which python  # Linux/macOS
/path/to/venv/bin/python

(venv) > where python  # Windows
C:\path\to\venv\Scripts\python.exe

安装的包会存储在虚拟环境的site-packages目录中

5. 虚拟环境的使用

5.1 安装包

激活虚拟环境后，可以使用pip安装项目所需的包：

# 安装最新版本的包
pip install requests

# 安装指定版本的包
pip install django==4.1.7

# 安装多个包
pip install requests flask numpy

# 从requirements.txt文件安装包
pip install -r requirements.txt

5.2 管理包

# 查看已安装的包
pip list

# 查看已安装包的详细信息
pip show requests

# 升级pip
pip install --upgrade pip

# 升级包
pip install --upgrade requests

# 卸载包
pip uninstall requests

# 卸载多个包
pip uninstall requests flask

5.3 运行Python程序

# 运行Python脚本
python app.py

# 运行Python解释器
python

# 运行Python模块
python -m mymodule

6. 虚拟环境的管理

6.1 查看虚拟环境信息

# 查看虚拟环境配置
cat venv/pyvenv.cfg  # Linux/macOS
type venv\pyvenv.cfg  # Windows

# 查看虚拟环境的Python版本
python --version

# 查看虚拟环境的pip版本
pip --version

6.2 修改虚拟环境

# 升级虚拟环境（Python 3.9+）
python -m venv --upgrade venv

# 清理虚拟环境中的包
pip uninstall -y -r <(pip freeze)

# 或重新创建虚拟环境
rm -rf venv  # Linux/macOS
del /s /q venv  # Windows
python -m venv venv

6.3 删除虚拟环境

# Linux/macOS
rm -rf venv

# Windows命令行
rmdir /s /q venv

# Windows PowerShell
Remove-Item -Recurse -Force venv

7. 依赖管理

7.1 导出依赖

将虚拟环境中的依赖包导出到requirements.txt文件：

# 导出所有依赖
pip freeze > requirements.txt

# 导出不包含pip、setuptools等内置包的依赖
pip list --format=freeze | grep -v "^pkg-resources" > requirements.txt  # Linux/macOS

# Windows PowerShell
pip list --format=freeze | Where-Object {$_ -notlike "pkg-resources*"} > requirements.txt

7.2 导入依赖

根据requirements.txt文件安装依赖：

# 安装所有依赖
pip install -r requirements.txt

# 忽略已安装的包
pip install --no-cache-dir -r requirements.txt

# 只下载不安装
pip download -d packages -r requirements.txt

7.3 依赖包的版本控制

在requirements.txt中可以指定包的版本约束：

# 精确版本
requests==2.28.2

# 大于等于指定版本
Flask>=2.2.3

# 小于指定版本
Django<5.0

# 版本范围
numpy>=1.21,<1.24

# 从Git仓库安装
git+https://github.com/user/repo.git@branch

# 从本地目录安装
-e ./mypackage

8. 高级用法

8.1 使用不同的Python版本

# 查看系统中可用的Python版本
which python3.9 python3.10 python3.11  # Linux/macOS
where python3.9 python3.10 python3.11  # Windows

# 使用特定Python版本创建虚拟环境
python3.10 -m venv myenv

# 或指定完整路径
/path/to/python3.10 -m venv myenv

8.2 包含全局站点包

创建虚拟环境时包含全局安装的包：

# 创建包含全局站点包的虚拟环境
python -m venv myenv --system-site-packages

# 验证是否包含全局包
pip list

8.3 自定义提示符

创建虚拟环境时指定自定义提示符：

# 指定提示符
python -m venv myenv --prompt "myproject"

# 激活后显示
(myproject) $

8.4 使用虚拟环境运行IDE

大多数现代IDE支持虚拟环境：

8.4.1 VS Code

打开项目目录
按Ctrl+Shift+P打开命令面板
输入"Python: Select Interpreter"
选择虚拟环境中的Python解释器

8.4.2 PyCharm

打开或创建项目
选择"File > Settings > Project > Python Interpreter"
点击齿轮图标，选择"Add..."
选择"Virtualenv Environment"
选择已有的虚拟环境或创建新的

8.5 虚拟环境的脚本自动化

创建自动化脚本来管理虚拟环境：

Windows批处理脚本（create_venv.bat）

@echo off

:: 创建虚拟环境
python -m venv venv

:: 激活虚拟环境
call venv\Scripts\activate.bat

:: 升级pip
pip install --upgrade pip

:: 安装依赖
if exist requirements.txt (
    pip install -r requirements.txt
    echo 依赖安装完成
) else (
    echo 未找到requirements.txt文件
)

echo 虚拟环境创建完成！
pause

Linux/macOS Shell脚本（create_venv.sh）

#!/bin/bash

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

# 升级pip
pip install --upgrade pip

# 安装依赖
if [ -f requirements.txt ]; then
    pip install -r requirements.txt
    echo "依赖安装完成"
else
    echo "未找到requirements.txt文件"
fi

echo "虚拟环境创建完成！"

# 赋予脚本执行权限
chmod +x create_venv.sh

# 执行脚本
./create_venv.sh

9. 常见问题与解决方案

9.1 激活虚拟环境失败

Windows PowerShell执行策略错误

无法加载文件 C:\path\to\venv\Scripts\Activate.ps1，因为在此系统上禁止运行脚本。

解决方案：

# 临时允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process

# 或永久设置为RemoteSigned
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Linux/macOS权限错误

-bash: venv/bin/activate: Permission denied

解决方案：

# 检查文件权限
ls -l venv/bin/activate

# 赋予执行权限
chmod +x venv/bin/activate

9.2 虚拟环境中没有pip

pip: command not found

解决方案：

# 重新创建虚拟环境并确保包含pip
python -m venv venv --without-pip  # 这会创建没有pip的虚拟环境

# 正确的方式是不使用--without-pip参数
python -m venv venv

# 或手动安装pip
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py
rm get-pip.py

9.3 依赖冲突

ERROR: Cannot install package1==1.0 and package2==2.0 because they conflict with each other.

解决方案：

检查依赖关系
```
pip check
```
升级或降级冲突的包
```
pip install package1==1.1
```
重新创建虚拟环境并安装兼容的包版本

9.4 虚拟环境占用过多空间

解决方案：

清理未使用的包
```
pip uninstall -y -r <(pip freeze)
```

重新创建虚拟环境

rm -rf venv
python -m venv venv
pip install -r requirements.txt

使用虚拟环境清理工具

pip install pip-autoremove
pip-autoremove package_name

9.5 在虚拟环境中使用不同的Python版本

解决方案：

安装所需版本的Python
使用该版本的Python创建虚拟环境
```
python3.10 -m venv venv
```

10. 最佳实践

10.1 虚拟环境命名

使用一致的命名约定：
- venv：默认且简洁
- .venv：隐藏目录，减少干扰
- env：常见但可能与环境变量混淆
- myproject-venv：项目特定的命名

10.2 .gitignore配置

将虚拟环境目录添加到.gitignore文件中：

# Python虚拟环境
venv/
.venv/
env/

# IDE虚拟环境配置
.idea/
.vscode/
*.swp
*.swo
*~

# 依赖文件
requirements.txt

10.3 文档化环境

创建README.md文件记录环境配置：

# 项目名称

## 环境配置

### 1. 创建虚拟环境
```bash
python -m venv venv

2. 激活虚拟环境

# Windows
venv\Scripts\activate.bat

# Linux/macOS
source venv/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 运行项目

python app.py


### 10.4 定期更新依赖

```bash
# 检查可更新的包
pip list --outdated

# 更新依赖并生成新的requirements.txt
pip install --upgrade -r requirements.txt
pip freeze > requirements.txt

10.5 使用虚拟环境进行开发

始终在虚拟环境中开发项目
避免全局安装包
为每个项目创建独立的虚拟环境
定期备份requirements.txt文件

11. 总结

虚拟环境是Python开发的重要工具，它可以：

隔离项目依赖
避免版本冲突
提高项目可移植性
增强开发安全性

使用venv模块创建虚拟环境的基本步骤：

创建：python -m venv venv
激活：
- Windows：venv\Scripts\activate.bat
- Linux/macOS：source venv/bin/activate
使用：安装包、运行程序
管理：安装、升级、卸载包
退出：deactivate

通过合理使用虚拟环境，可以显著提高Python开发的效率和项目的可维护性。

发布网站：荣殿教程（zhangrongdian.com）作者：张荣殿 发布日期：2026-01-19

Python虚拟环境(venv)创建详解

1. 概述

1.1 为什么需要虚拟环境

1.2 Python虚拟环境工具

2. venv模块简介

2.1 venv的特点

2.2 venv的工作原理

3. 虚拟环境的创建

3.1 基本语法

3.2 常用参数

3.3 不同平台的创建示例

3.3.1 Windows平台

3.3.2 Linux/macOS平台

3.4 虚拟环境的目录结构

4. 虚拟环境的激活

4.1 Windows平台

4.1.1 Windows命令行（cmd.exe）

4.1.2 Windows PowerShell

4.1.3 Windows Git Bash

4.2 Linux/macOS平台

4.3 激活后的变化

5. 虚拟环境的使用

5.1 安装包

5.2 管理包

5.3 运行Python程序

6. 虚拟环境的管理

6.1 查看虚拟环境信息

6.2 修改虚拟环境

6.3 删除虚拟环境

7. 依赖管理

7.1 导出依赖

7.2 导入依赖

7.3 依赖包的版本控制

8. 高级用法

8.1 使用不同的Python版本

8.2 包含全局站点包

8.3 自定义提示符

8.4 使用虚拟环境运行IDE

8.4.1 VS Code

8.4.2 PyCharm

8.5 虚拟环境的脚本自动化

Windows批处理脚本（create_venv.bat）

Linux/macOS Shell脚本（create_venv.sh）

9. 常见问题与解决方案

9.1 激活虚拟环境失败

Windows PowerShell执行策略错误

Linux/macOS权限错误

9.2 虚拟环境中没有pip

9.3 依赖冲突

9.4 虚拟环境占用过多空间

9.5 在虚拟环境中使用不同的Python版本

10. 最佳实践

10.1 虚拟环境命名

10.2 .gitignore配置

10.3 文档化环境

2. 激活虚拟环境

3. 安装依赖

4. 运行项目

10.5 使用虚拟环境进行开发

11. 总结

关注我们的微信公众号