如何在 Windows 上安装 Django — Django 文档
如何在 Windows 上安装 Django
本文档将指导您在 Windows 上安装 Python 3.8 和 Django。 它还提供了设置虚拟环境的说明,这使得在 Python 项目上工作变得更加容易。 这是为从事 Django 项目的用户提供的初学者指南,并不反映在为 Django 本身开发补丁时应如何安装 Django。
本指南中的步骤已经过 Windows 10 测试。 在其他版本中,步骤类似。 您需要熟悉使用 Windows 命令提示符。
安装 Python
Django 是一个 Python Web 框架,因此需要在您的机器上安装 Python。 在撰写本文时,Python 3.8 是最新版本。
要在您的机器上安装 Python,请访问 https://www.python.org/downloads/。 该网站应该为您提供最新 Python 版本的下载按钮。 下载可执行安装程序并运行它。 选中“为所有用户安装启动器(推荐)”旁边的框,然后单击“立即安装”。
安装后,打开命令提示符并通过执行以下命令检查 Python 版本是否与您安装的版本匹配:
...\> py --version
也可以看看
有关更多详细信息,请参阅 python:using/windows 文档。
关于pip
pip 是 Python 的包管理器,默认包含在 Python 安装程序中。 它有助于安装和卸载 Python 包(例如 Django!)。 对于安装的其余部分,我们将使用 pip
从命令行安装 Python 包。
设置虚拟环境
最佳实践是为您创建的每个 Django 项目提供一个专用环境。 在 Python 生态系统中有许多管理环境和包的选项,其中一些在 Python 文档 中有推荐。 Python 本身带有 venv 用于管理我们将在本指南中使用的环境。
要为您的项目创建虚拟环境,请打开一个新的命令提示符,导航到您要创建项目的文件夹,然后输入以下内容:
...\> py -m venv project-name
如果它不存在并设置虚拟环境,这将创建一个名为“project-name”的文件夹。 要激活环境,请运行:
...\> project-name\Scripts\activate.bat
虚拟环境将被激活,您将在命令提示符旁边看到“(项目名称)”来指定它。 每次启动新的命令提示符时,都需要再次激活环境。
安装 Django
可以在您的虚拟环境中使用 pip
轻松安装 Django。
在命令提示符中,确保您的虚拟环境处于活动状态,然后执行以下命令:
...\> py -m pip install Django
这将下载并安装最新的 Django 版本。
安装完成后,您可以通过在命令提示符下执行 django-admin --version
来验证您的 Django 安装。
有关使用 Django 安装数据库的信息,请参阅 使您的数据库运行 。
彩色终端输出
3.2 版中的新功能。
生活质量功能为终端添加了彩色(而不是单色)输出。 在现代终端中,这应该适用于 CMD 和 PowerShell。 如果由于某种原因需要禁用此功能,请将环境变量 DJANGO_COLORS 设置为 nocolor
。
在较旧的 Windows 版本或旧终端上,必须安装 colorama 以启用语法着色:
...\> py -m pip install colorama
有关颜色设置的更多信息,请参阅 语法着色 。
常见的陷阱
如果
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
通常,Django 假定
UTF-8
编码用于 I/O。 如果您的系统设置为使用不同的编码,这可能会导致问题。 最近版本的 Python 允许设置PYTHONUTF8
环境变量以强制使用UTF-8
编码。 Windows 10 还通过在系统设置中的 中检查Use Unicode UTF-8 for worldwide language support
来提供系统范围的设置。