作为一名 Python 程序员,你一定遇到过这样的困境:项目 A 需要依赖包版本 1.0,而项目 B 却必须使用 2.0 版本,两者水火不容。如果不加隔离,你的本地环境迟早会陷入“依赖地狱”。

这时,Python 的虚拟环境(Virtual Environment)就成了你的救星。它为你的每个项目提供了一个独立、干净的 Python 运行空间,彻底解决了版本冲突问题。

本文将详细指导你使用 Python 标准库中的 venv 工具,完成虚拟环境的创建激活退出


第一步:为什么需要虚拟环境?

在深入操作之前,我们先来明确一下它的核心价值:

  1. 隔离性: 每个项目的依赖包都安装在自己的环境内,不会相互干扰。

  2. 干净利落: 你的操作系统 Python 环境保持纯净,只包含必要的系统工具。

  3. 项目迁移: 通过 requirements.txt 文件,你可以轻松地在任何机器上重现你的开发环境。


第二步:创建虚拟环境

我们推荐使用 Python 3.3 及以上版本自带的 venv 模块。

1. 切换到项目根目录

进入你想要创建虚拟环境的项目文件夹。

Bash

cd /path/to/your/project

2. 执行创建命令

在终端中运行以下命令,创建一个名为 venv 的虚拟环境文件夹。

提示: 尽管你可以随意命名,但通常约定俗成使用 venvenv 作为文件夹名。

Bash

# Windows/Linux/macOS 通用命令
python -m venv venv

执行成功后,你的项目目录下会多出一个名为 venv 的文件夹,里面包含了该项目独立的 Python 解释器和 pip 工具。


第三步:激活(进入)虚拟环境

创建只是第一步,要让你的终端开始使用这个独立环境,你必须激活它。

激活命令取决于你所使用的操作系统和终端类型。

🌐 Linux / macOS

使用 source 命令来激活:

Bash

source venv/bin/activate

🪟 Windows (Command Prompt - CMD)

使用 activate.bat 脚本:

Bash

venv\Scripts\activate.bat

💻 Windows (PowerShell)

使用 Activate.ps1 脚本:

Bash

venv\Scripts\Activate.ps1

注意: 在某些 PowerShell 版本中,可能会遇到“脚本执行策略”的限制。如果遇到错误,请搜索相关解决方案,或暂时切换到 CMD 进行操作。

✅ 激活成功的标志

当你成功激活虚拟环境后,你会发现你的终端提示符(Prompt)前面多了一个括号包裹的环境名称,例如:

Bash

(venv) /path/to/your/project $

退出虚拟环境

当你完成了在这个项目中的工作,或者需要切换到另一个项目的环境时,只需运行一个简单的命令即可退出:

Bash

deactivate

运行后,你终端前面的 (venv) 标志将消失,说明你已回到系统默认的 Python 环境。


常用后续操作

一旦进入虚拟环境,你可以像往常一样安装依赖包。此时所有安装都会被隔离在 (venv) 目录内。

1. 安装依赖包

Bash

(venv) pip install requests pandas

2. 导出依赖列表

这是项目迁移的关键步骤,将当前环境所有已安装的包及其版本冻结到一个文件中:

Bash

(venv) pip freeze > requirements.txt

3. 从文件安装依赖

在新的环境或新的机器上,激活虚拟环境后,使用此命令快速安装所有依赖:

Bash

(venv) pip install -r requirements.txt

掌握了虚拟环境的使用,你的 Python 开发之旅将更加清晰、高效、无忧!现在,就开始为你下一个项目创建一个干净的环境吧!

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐