练习 - 设置开发环境

15 分钟

若要开始用 Python 编写 Flask 应用程序，我们需要设置开发环境，这将需要安装几个项目。幸运的是，我们要使用的工具都相对通用，因此即使在本模块之外，它们也可以得到充分利用。你甚至有可能已安装这些工具！我们将使用这些工具在本地开发和测试应用程序。

在本单元中，你将学习如何安装 Python 工具并创建虚拟 Python 环境。你将安装 Flask，这是我们将用于创建网站的框架。

重要

在本模块中，你将安装和配置各种软件包，并创建 Python 虚拟环境。在命令提示符窗口或终端中激活虚拟环境后，使窗口或终端保持打开状态。如果关闭窗口或终端，请确保在新的窗口或终端中重新启动相同的 Python 虚拟环境。在本模块开头创建的相同 Python 虚拟环境中完成所有工作是很重要的。

大致来看，我们将执行以下步骤：

安装 Visual Studio Code（如果尚未安装）
安装 Python（如果尚未安装）
为代码创建目录
创建虚拟环境
安装 Flask 和其他库

安装 Visual Studio Code

Visual Studio Code 是一种开放源代码编辑器，让你能够创建几乎任何类型的应用程序。这款编辑器由强大的扩展市场提供支持，你可以从扩展市场中找到附加产品，简化自己的开发者生活。

下载 Visual Studio Code

安装 Python

若要完成本单元的学习，你的计算机上必须安装 Python 3.6 或更高版本。你可能已经安装了 Python，特别是在你已经使用过它的情况下。可以通过执行下面的其中一条命令来确认是否已安装：

python --version

如果已安装 Python，则输出将显示 Python 版本号。如果需要安装 Python，请按照安装 Python 解释器文档中针对 Visual Studio Code 的步骤进行操作。还需要安装 Visual Studio Code Python 扩展。

重要

如果使用 Windows，请确保将安装 Python 的文件夹位置添加到 PATH 环境变量中。如果缺少这一步，即使在执行安装操作后，你也会收一条错误消息“找不到 Python”。若要解决此问题，需要按照以下步骤将 Python 添加到 PATH 环境变量：

查找包含 python.exe 文件的目录。可以在命令提示符终端中键入 python where，以查找 python.exe 文件
复制路径值“C:\<python path>”，将其添加到步骤 6 中的 Path 变量
单击“开始”菜单并键入“编辑系统环境变量”，这将打开系统属性窗口。
在“高级”选项卡下，单击“环境变量”按钮。
在用户变量下，双击名为“Path”的变量，这将弹出一个窗口，其中包含路径列表
单击“新建”并粘贴复制的路径。
插入后，单击“确定”，现在应该就可以从计算机中的任何位置访问 Python

注意

若要验证路径配置是否成功，请打开新的命令提示符终端并键入 python 以查看 python 版本信息。如果仍无法运行 python 命令，请重启计算机，使更改生效。

创建项目目录

在你选择的位置创建目录。该目录将作为你的项目目录，其中将包含我们要创建的所有代码。可以使用下面的其中一条命令从命令或终端窗口创建目录：

# Windows, macOS or Linux
mkdir contoso
cd contoso

重要

对于整个模块，都请让命令或终端窗口保持打开状态。

创建 Python 虚拟环境

Python 虚拟环境并不一定像听起来那么复杂。虚拟环境不是创建虚拟机或容器，而是一个包含运行应用程序所需的所有库的文件夹（包括 Python 运行时本身）。利用虚拟环境，我们使应用程序实现模块化，这样我们就能让应用程序彼此独立并避免出现版本问题。作为最佳做法，在使用 Python 时，应该始终使用虚拟环境。

为使用虚拟环境，我们将创建并激活虚拟环境。我们使用 venv 模块来创建虚拟环境，该模块在先前的 Python 安装说明中已安装。激活虚拟环境时，我们会告诉系统将我们创建的文件夹用于其所有的 Python 需求。

# Windows, macOS or Linux
# Create the environment
python -m venv venv

创建虚拟环境的过程可能需要几秒钟。在激活环境之前，请等待终端提示再次出现。

# Windows
# Activate the environment
./venv/scripts/activate

# macOS or Linux
# Activate the environment
source ./venv/bin/activate

安装 Flask 和其他库

随着虚拟环境的创建和激活，我们现在可以安装 Flask，这是网站所需的库。我们将遵循常见约定来安装 Flask，即创建一个“requirements.txt”文件。 “requirements.txt”文件本身并不特殊；它是一个文本文件，其中列出了应用程序所需的库。但这是开发人员通常使用的约定，可使管理依赖大量库的应用程序变得更轻松。

在后面的练习中，我们将使用几个其他库，包括请求（用于调用翻译器服务）和 python-dotenv（用于管理密钥）。虽然我们现在还不需要这些库，但现在安装会让这一过程更轻松一些。

在命令或终端窗口中，运行以下命令以在 Visual Studio Code 中打开目录：
```
code .
```
在 Visual Studio Code 的“资源管理器”窗口中，选择 contoso 目录旁边的“新建文件”
将文件命名为 requirements.txt，然后添加以下文本：
```
flask
python-dotenv
requests
```
在 Mac 上，通过单击“Ctrl-S”或“Cmd-S”来保存文件
返回到命令或终端窗口，使用 pip 运行以下命令来执行安装：
```
pip install -r requirements.txt
```

该命令下载所需的库及其依赖项。

备注

如果 pip 不是最新版本，则可能会收到错误消息。按照错误消息中的说明执行升级。此模块不要求升级。