【译】如何在 Windows 上激活 virtualenv 虚拟环境

网上有很多关于激活虚拟环境的方法，但是我只想通过命令行执行，于是就把这篇文章翻译一下，当做自己的笔记，今后随时查阅，也希望对新手学习 Python 有帮助。

原文链接：linuxhint.com/activate-vi…

作者：Rafia Zafar，毕业于计算机科学专业。linuxhint 社区的初级技术作者，对编程和学习新技术充满热情。使用过 JAVA、HTML 5、CSS3、Bootstrap 和 PHP。

virtualenv 是 Python 的核心组件和工具之一，它封装了 Python 项目的可执行包和依赖项。virtualenv 的这种封装功能为 Python 程序提供了隔离。virtualenv 可以通过 Python 的 pip 包管理器轻松安装。

本文将演示：

• 先决条件：在 Windows 上安装 Python
• 如何在 Windows 上安装 pip？
• 如何在 Windows 上激活 virtualenv？
• 如何在 Windows 上停用 virtualenv？
• 额外提示：解决 “virtualenv 未被识别为内部或外部命令” 错误（virtualenv is not recognized as an internal or external command）

先决条件：在 Windows 上安装 Python

要在 Windows 上安装和激活 virtualenv，您需要先安装 Python。

第 1 步：下载 Python 安装程序

访问 Python 官方网站并安装最新版本的 Windows Python 安装程序：

第 2 步：安装 Python

从您的计算机打开“下载”目录。双击 Python 安装程序开始安装：

标记“Add python.exe to PATH”复选框，然后点击下面突出显示的“立即安装”选项以安装 Python：

在这里，你可以看到我们已经在 Windows 上成功安装了 Python：

第 3 步：验证

通过“启动”菜单启动命令提示符，然后使用提供的命令检查 Python 版本：

python --version

如上图，安装了最新版本的 Python 3.11.2。

如何在 Windows 上安装“pip”？

virtualenv 可以通过 Python pip 包管理器进行安装。但是，pip 已作为 Python 安装的一部分进行安装。如果未安装 pip，您可以通过访问我们的相关文章使用其他方法将其安装在 Windows 上。

要在 Windows 上使用“curl”命令安装 pip，请查看给定的过程。

第 1 步：打开命令提示符 CMD

通过“开始”菜单启动 Windows 命令提示符：

第 2 步：下载“get-pip.py”文件

使用 “curl” 命令，从“ https://bootstrap.pypa.io/get-pip.py ”读取脚本文件，并使用 -o 选项将其写入名为“get-pip.py”的新文件中，因为它不能直接下载到系统中：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

第 3 步：安装 pip

使用 Python 命令执行“get-pip.py”文件，在 Windows 上安装 pip：

python get-pip.py

要进行验证，请检查 pip 版本：

pip --version

可以注意到，pip版本“23.0.1”安装在 Windows 上。

如何在 Windows 上激活 virtualenv？

virtualenv 是 Python 的环境，用于隔离 Python 项目和依赖项。要在 Windows 上激活 virtualenv，请先通过“pip”包管理器安装它。激活 Python 项目的 virtualenv。对于演示，请按照列出的步骤操作。

第 1 步：安装 virtualenv

要安装 Python virtualenv，请使用“ pip install virtualenv ”命令：

pip install virtualenv

第 2 步：创建项目目录

安装完成后，创建需要启动 Python 开发的 Python 项目目录。为此，首先，使用“mkdir”命令创建目录。然后，使用“cd”导航到新创建的目录：

$ mkdir project-dir
$ cd project-dir

第 3 步：为项目目录创建 virtualenv

使用“ virtualenv <environment-name> ”命令创建新的虚拟环境：

virtualenv venvironment

第 4 步：激活 “venvironment” virtualenv

接下来，通过“<environment-name>\Scripts\activate”命令激活新创建的虚拟环境：

venvironment\Scripts\activate

输出显示虚拟环境已在 Windows 上激活。

译注：如果在 git bash 上运行，得到如下错误的话：

$ venv/Scripts/activate
You must source this script: $ source venv/Scripts/activate

需要使用 $ source venv/Scripts/activate 进行激活

如何在 Windows 上停用 virtualenv？

要在 Windows 上停用 virtualenv，只需使用“deactivate”命令：

deactivate

额外提示：如何解决“virtualenv 未被识别为内部或外部命令”错误（virtualenv is not recognized as an internal or external command）

在某些情况下，由于各种原因，Windows用户可能会收到virtualenv识别错误，例如：

• virtualenv 未正确安装在 Windows 上(virtualenv is not properly installed on Windows)
• 未设置 virtualenv 的路径变量。(Path variable of virtualenv is not set.)

为了诊断正确的原因，首先，通过转到“C：\Users\AppData\Local\Programs\Python<username>Python311\Scripts”路径导航到 Python 脚本目录，并查看“virtualenv.exe”文件是否存在。如果没有，则表示 virtualenv 未安装在 Windows 上，因为 virtualenv 的环境变量路径是在安装过程中自动设置的。要安装 virtualenv，请按照上述部分操作。

如果安装了 virtualenv，但错误仍然存在;这意味着 PATH 变量设置不正确，我们需要手动设置。

如何手动设置 virtualenv 的 PATH 环境变量？

要解决此错误，请按照以下说明设置 PATH 环境变量。

第 1 步：启动环境变量设置

首先，在“开始”菜单的搜索栏中搜索“环境变量”，然后启动下面突出显示的设置：

中文环境如下：

接下来，点击“环境变量”按钮打开系统环境变量：

第 2 步：编辑“路径”变量

在“用户变量”下，选择“路径”变量，然后按“编辑”按钮：

第 3 步：设置 virtualenv 的 PATH 变量

之后，点击“新建”按钮，添加“virtualenv.exe”文件所在的目录的路径，然后按“确定”按钮。默认情况下，“virtualenv.exe”文件保存在“C：\Users\<username>AppData\Local\Programs\Python\Python311\Scripts”路径中：

注意： 请确保将“<username>”替换为您自己的系统用户名。

如果在 Windows 上激活 virtualenv 时发生 virtualenv 识别错误，这可以解决该错误。

结论

要在 Windows 上激活 virtualenv，首先，安装 Python 和 pip。然后，通过 Python 的 pip 包管理器安装 virtualenv。之后，移动到项目目录，使用“virtualenv”命令创建 virtualenv <environment-name>，并通过“environment-name\Scripts\activate”命令激活环境。

本文演示了如何在 Windows 上激活 virtualenv。