Python 虚拟环境：使用 venv 隔离项目依赖

Travis Tang

2024-07-21

前言

在开发 Python 项目时，管理项目的依赖关系是一个常见的挑战。不同项目可能需要不同版本的库，如果不加以管理，很容易导致依赖冲突和环境混乱。幸运的是，Python 提供了虚拟环境（virtual environment）的解决方案，帮助我们隔离项目依赖，确保每个项目的环境独立且干净。今天，我想和大家分享如何使用 Python 的 venv 模块来创建和管理虚拟环境，希望能为你的项目开发提供便利。

1. 什么是虚拟环境？

虚拟环境是一种隔离的 Python 环境，能够独立安装和管理项目所需的库和包。通过使用虚拟环境，可以避免不同项目之间的依赖冲突，确保项目在其特定环境中运行。

2. 创建虚拟环境

Python 的 venv 模块可以方便地创建虚拟环境。首先，确保你已经安装了 Python（3.3 及以上版本），因为 venv 是 Python 自带的模块。

步骤

打开命令行窗口。
导航到你的项目目录。
运行以下命令创建虚拟环境：

1	python -m venv myenv

这里，myenv 是虚拟环境的名称，可以根据你的喜好命名。

3. 激活虚拟环境

创建虚拟环境后，需要激活它以便在该环境中安装和使用包。

Windows

1	myenv\Scripts\activate

MacOS/Linux

1	source myenv/bin/activate

激活虚拟环境后，你会在命令行提示符前看到虚拟环境的名称，例如 (myenv)，表示当前正在使用该虚拟环境。

4. 安装依赖包

在激活虚拟环境后，可以像平常一样使用 pip 来安装项目依赖包。例如，安装 requests 库：

1	pip install requests

此时，requests 库将被安装到虚拟环境中，而不会影响全局 Python 环境。

5. 记录依赖

为了便于团队协作和项目部署，建议将项目的依赖包记录到一个文件中，通常命名为 requirements.txt。

生成 `requirements.txt`

在项目根目录下运行以下命令：

1	pip freeze > requirements.txt

此时，所有已安装的包及其版本信息将被写入 requirements.txt 文件。

安装依赖

其他开发者或在新环境中，可以通过以下命令安装 requirements.txt 中记录的依赖包：

1	pip install -r requirements.txt

6. 退出虚拟环境

完成开发工作后，可以通过以下命令退出虚拟环境，返回到全局 Python 环境：

1	deactivate

7. 删除虚拟环境

如果不再需要某个虚拟环境，可以直接删除其目录。例如，删除 myenv 目录：

1	rm -rf myenv

8. 示例项目

下面我们通过一个简单的示例项目来总结上述步骤。假设我们有一个项目，需要使用 requests 库来发送 HTTP 请求。

创建项目目录和文件

1 2	mkdir my_project cd my_project

创建并激活虚拟环境：

1
2
3

python -m venv myenv
source myenv/bin/activate  # MacOS/Linux
myenv\Scripts\activate     # Windows

安装 requests 库：

1	pip install requests

创建一个 Python 脚本 main.py，内容如下：

import requests

response = requests.get('https://api.github.com')
print(response.json())

记录依赖包：

1	pip freeze > requirements.txt

运行脚本：

1	python main.py

代码解释

导入 requests 库。
发送 GET 请求到 GitHub API。
输出响应的 JSON 内容。

结论

通过学习和应用 venv 模块，我们可以有效地管理项目依赖，避免依赖冲突，提高开发效率和项目的可维护性。希望这篇文章能帮助你掌握虚拟环境的基本操作，并应用到实际项目中。如果你喜欢这篇文章，请关注我的博客并收藏本文，后续会有更多精彩内容分享给大家！

前言