Python

Python 虚拟环境管理指南

警告
本文最后更新于 2026-04-02,文中内容可能已过时。

在 Python 开发中,不同项目常需要不同版本的库,全局环境易引发冲突,而虚拟环境可为每个项目提供独立的运行空间,避免依赖冲突,并通过 requirements.txt 锁定版本。以 requests 为例,项目 A 需要 2.28.0,项目 B 需要 2.31.0,通过虚拟环境可分别为两个项目安装所需版本,互不干扰。

下面将基于 Windows 系统,介绍如何使用 Python 内置的 venv 模块创建和管理虚拟环境。

创建虚拟环境

运行以下命令,创建虚拟环境:

Bash
1
python -m venv .venv

执行后,将生成 .venv 目录,其中包含独立的 Python 解释器和 pip

激活虚拟环境

运行以下命令,激活虚拟环境:

Bash
1
source .venv/Scripts/activate

激活后,命令行会显示 (.venv),如:

Bash
1
(.venv) PS D:\myproject>

管理项目依赖

运行以下命令,安装项目依赖:

Bash
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
# 安装单个包
pip install requests

# 一次安装多个包
pip install requests beautifulsoup4 chardet

# 安装特定版本的包
pip install requests==2.28.0

# 安装 requirements.txt 中列出的所有包
pip install -r requirements.txt

# 升级单个包到最新版本
pip install --upgrade requests

# 卸载单个包
pip uninstall requests

# 查看已安装的包
pip list

运行以下命令,记录项目依赖:

Bash
1
2
# 将当前环境中已安装的包及版本写入 requirements.txt
pip freeze > requirements.txt

运行 Python 脚本

运行以下命令,执行 Python 脚本:

Bash
1
2
3
4
5
# 在当前目录运行脚本
python your_script.py

# 脚本在子目录,并传入参数(如文件路径)
python scripts/your_script.py "./scripts/your_file.md"

退出虚拟环境

运行以下命令,退出虚拟环境:

Bash
1
deactivate

删除与重建虚拟环境

运行以下命令,删除虚拟环境目录:

Bash
1
rm -rf .venv

之后可重新创建虚拟环境(运行 python -m venv .venv)。

留言交流