Django/docs/3.0.x/howto/windows

如何在 Windows 上安装 Django

本文档将指导您在 Windows 上安装 Python 3.8 和 Django。 它还提供了设置虚拟环境的说明，这使得在 Python 项目上工作变得更加容易。 这是为从事 Django 项目的用户提供的初学者指南，并不反映在为 Django 本身开发补丁时应如何安装 Django。

本指南中的步骤已经过 Windows 10 测试。 在其他版本中，步骤类似。 您需要熟悉使用 Windows 命令提示符。

安装 Python

Django 是一个 Python Web 框架，因此需要在您的机器上安装 Python。 在撰写本文时，Python 3.8 是最新版本。

要在您的机器上安装 Python，请访问 https://python.org/downloads/。 该网站应该为您提供最新 Python 版本的下载按钮。 下载可执行安装程序并运行它。 选中“为所有用户安装启动器（推荐）”旁边的框，然后单击“立即安装”。

安装后，打开命令提示符并通过执行以下命令检查 Python 版本是否与您安装的版本匹配：

...\> py --version

Copy

也可以看看

有关更多详细信息，请参阅 python:using/windows 文档。

关于pip

pip 是 Python 的包管理器，默认包含在 Python 安装程序中。 它有助于安装和卸载 Python 包（例如 Django！）。 对于安装的其余部分，我们将使用 pip 从命令行安装 Python 包。

设置虚拟环境

最佳实践是为您创建的每个 Django 项目提供一个专用环境。 在 Python 生态系统中有许多管理环境和包的选项，其中一些在 Python 文档 中有推荐。 Python 本身带有 venv 用于管理我们将在本指南中使用的环境。

要为您的项目创建虚拟环境，请打开一个新的命令提示符，导航到您要创建项目的文件夹，然后输入以下内容：

...\> py -m venv project-name

Copy

如果它不存在并设置虚拟环境，这将创建一个名为“project-name”的文件夹。 要激活环境，请运行：

...\> project-name\Scripts\activate.bat

Copy

虚拟环境将被激活，您将在命令提示符旁边看到“（项目名称）”来指定它。 每次启动新的命令提示符时，都需要再次激活环境。

安装 Django

可以在您的虚拟环境中使用 pip 轻松安装 Django。

在命令提示符中，确保您的虚拟环境处于活动状态，然后执行以下命令：

...\> py -m pip install Django

Copy

这将下载并安装最新的 Django 版本。

安装完成后，您可以通过在命令提示符下执行 django-admin --version 来验证您的 Django 安装。

有关使用 Django 安装数据库的信息，请参阅 使您的数据库运行 。

常见的陷阱

• 如果 django-admin 无论给出什么参数都只显示帮助文本，则 Windows 中的文件关联可能有问题。 检查 PATH 中是否设置了多个用于运行 Python 脚本的环境变量。 这通常发生在安装了多个 Python 版本时。

• 如果您通过代理连接到 Internet，则在运行命令 py -m pip install Django 时可能会出现问题。 在命令提示符中设置代理配置的环境变量如下：

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport

  Copy