如何在Windows上安装Django

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

本指南中的步骤已在Windows 10上进行了测试。在其他版本中,步骤类似。您需要熟悉Windows命令提示符的使用。

安装Python

Django是一个Python Web框架,因此需要在您的计算机上安装Python。在撰写本文时,Python3.12是最新版本。

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

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

...\> py --version

参见

有关详细信息,请参阅 Using Python on Windows 文档。

关于 pip

pip 是一个适用于Python的包管理器,默认情况下包含在Python安装程序中。它有助于安装和卸载Python包(如Django!)。对于安装的其余部分,我们将使用 pip 要从命令行安装Python包,请执行以下操作。

设置虚拟环境

最好为您创建的每个Django项目提供一个专用的环境。在Python生态系统中有许多管理环境和包的选项,在 Python documentation . Python本身 venv 用于管理我们将用于本指南的环境。

要为项目创建虚拟环境,请打开新的命令提示符,导航到要在其中创建项目的文件夹,然后输入以下内容:

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

这将创建一个名为‘project-name’的文件夹(如果该文件夹尚不存在),并设置虚拟环境。要激活环境,请运行以下命令:

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

虚拟环境将被激活,您将在命令提示符旁边看到“(project name)”来指定它。每次启动新的命令提示符时,都需要再次激活环境。

安装Django

Django可以使用 pip 在您的虚拟环境中。

在命令提示符下,确保您的虚拟环境处于活动状态,并执行以下命令:

...\> py -m pip install Django

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

安装完成后,可以通过执行 django-admin --version 在命令提示下。

使数据库运行 有关使用Django安装数据库的信息。

彩色端子输出

生活质量功能将彩色(而不是单色)输出添加到终端。在现代终端中,这应该既适用于CMD,也适用于PowerShell。如果出于某种原因需要禁用此功能,请设置环境变量 DJANGO_COLORSnocolor

在较旧的Windows版本或传统终端上, colorama 必须安装0.4.6以上版本才能启用语法着色:

...\> py -m pip install "colorama >= 0.4.6"

看见 语法颜色标记 有关颜色设置的详细信息,请参阅。

常见的陷阱

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

  • 如果您在代理后连接到Internet,则运行该命令可能会出现问题 py -m pip install Django 。在命令提示符下设置代理配置的环境变量,如下所示:

    ...\> set http_proxy=http://username:password@proxyserver:proxyport
    ...\> set https_proxy=https://username:password@proxyserver:proxyport
    
  • 一般来说,Django假设 UTF-8 编码用于I/O。如果您的系统设置为使用不同的编码,这可能会导致问题。最新版本的Python允许设置 PYTHONUTF8 环境变量,以强制 UTF-8 编码。Windows 10还提供系统范围的设置,方法是选中 Use Unicode UTF-8 for worldwide language support 在……里面 Language ‣ Administrative Language Settings ‣ Change system locale 在系统设置中。