如何安装 Django

本文档将帮助您启动并运行 Django。

安装 Python

Django 是一个 Python Web 框架。有关详细信息，请参阅我可以在 Django 中使用哪个 Python 版本？。

在 https://www.python.org/downloads/ 或使用操作系统的包管理器获取最新版本的 Python。

Windows 上的 Python

如果您刚开始接触 Django 并使用 Windows，您可能会发现如何在 Windows 上安装 Django 很有用。

安装 Apache 和 mod_wsgi

如果您只是想尝试 Django，请跳到下一部分； Django 包含一个可用于测试的轻量级 Web 服务器，因此在您准备好在生产中部署 Django 之前，您无需设置 Apache。

如果您想在生产站点上使用 Django，请使用 Apache 和 mod_wsgi。 mod_wsgi 以两种模式之一运行：嵌入式模式或守护进程模式。在嵌入式模式下，mod_wsgi 类似于 mod_perl——它在 Apache 中嵌入 Python，并在服务器启动时将 Python 代码加载到内存中。代码在 Apache 进程的整个生命周期中都保留在内存中，与其他服务器安排相比，这会带来显着的性能提升。在守护进程模式下，mod_wsgi 产生一个独立的守护进程来处理请求。守护进程可以作为与 Web 服务器不同的用户运行，这可能会提高安全性。守护进程可以在不重启整个 Apache Web 服务器的情况下重启，这可能使您的代码库刷新更加无缝。请查阅 mod_wsgi 文档以确定哪种模式适合您的设置。确保您安装了 Apache 并激活了 mod_wsgi 模块。 Django 可以与任何支持 mod_wsgi 的 Apache 版本一起使用。

请参阅 How to use Django with mod_wsgi 了解安装 mod_wsgi 后如何配置它。

如果由于某种原因不能使用 mod_wsgi，请不要担心：Django 支持许多其他部署选项。一个是uWSGI；它与 nginx 配合得很好。此外，Django 遵循 WSGI 规范（PEP 3333），这使它能够在各种服务器平台上运行。

让你的数据库运行

如果您打算使用 Django 的数据库 API 功能，则需要确保数据库服务器正在运行。 Django 支持许多不同的数据库服务器，官方支持 PostgreSQL、MariaDB、MySQL、Oracle 和 SQLite .

如果你正在开发一个小项目或不打算在生产环境中部署的东西，SQLite 通常是最好的选择，因为它不需要运行单独的服务器。但是，SQLite 与其他数据库有很多不同，因此如果您正在处理一些实质性的工作，建议使用您计划在生产中使用的相同数据库进行开发。

除了官方支持的数据库外，还有第三方提供的后端，可以让你在Django中使用其他数据库。

除了数据库后端，您还需要确保安装了 Python 数据库绑定。

如果您使用 PostgreSQL，则需要 psycopg2 包。有关更多详细信息，请参阅 PostgreSQL 注释。
如果您使用 MySQL 或 MariaDB，则需要一个 DB API 驱动程序，例如 mysqlclient。有关详细信息，请参阅 MySQL 后端的注释。
如果您使用 SQLite，您可能需要阅读 SQLite 后端说明。
如果您使用 Oracle，则需要 cx_Oracle 的副本，但请阅读 Oracle 后端的注释以了解有关 Oracle 和支持版本的详细信息X188X]。
如果您使用的是非官方的第 3 方后端，请参阅提供的文档以了解任何其他要求。

如果您打算使用 Django 的 manage.py migrate 命令为您的模型自动创建数据库表（在首次安装 Django 并创建项目之后），您需要确保 Django 具有在数据库中创建和更改表的权限你正在使用；如果您计划手动创建表，您可以授予 Django SELECT、INSERT、UPDATE 和 DELETE 权限。创建具有这些权限的数据库用户后，您将在项目的设置文件中指定详细信息，有关详细信息，请参阅 :setting:`DATABASES`。

如果您使用 Django 的测试框架来测试数据库查询，则 Django 将需要创建测试数据库的权限。

安装 Django 代码

安装说明略有不同，具体取决于您是安装特定于发行版的软件包、下载最新的官方版本还是获取最新的开发版本。

使用 pip 安装正式版本

这是安装 Django 的推荐方式。

安装 pip。最简单的方法是使用独立 pip 安装程序。如果您的发行版已经安装了 pip，如果它已经过时，您可能需要更新它。如果它已过时，您就会知道，因为安装将不起作用。
看看venv。这个工具提供了隔离的 Python 环境，这比在系统范围内安装包更实用。它还允许在没有管理员权限的情况下安装软件包。贡献教程介绍了如何创建虚拟环境。
创建并激活虚拟环境后，输入命令：

安装特定于发行版的包

检查发行版特定说明以查看您的平台/发行版是否提供官方 Django 包/安装程序。分发提供的包通常允许自动安装依赖项和支持的升级路径；然而，这些包很少包含最新版本的 Django。

安装开发版

跟踪 Django 开发

如果您决定使用 Django 的最新开发版本，您需要密切关注开发时间表，并且您需要密切关注即将发布的发行说明发布。这将帮助您掌握可能想要使用的任何新功能，以及在更新 Django 副本时需要对代码进行的任何更改。（对于稳定版本，任何必要的更改都记录在发行说明中。）

如果您希望能够使用最新的错误修复和改进不时更新您的 Django 代码，请按照以下说明操作：

确保你已经安装了 Git 并且你可以从 shell 运行它的命令。（在 shell 提示下输入 git help 来测试这个。）
像这样查看 Django 的主要开发分支：

这将在您的当前目录中创建一个目录 django。
确保 Python 解释器可以加载 Django 的代码。最方便的方法是使用虚拟环境和 pip。贡献教程介绍了如何创建虚拟环境。
设置并激活虚拟环境后，运行以下命令：

这将使 Django 的代码可导入，并且还将使 django-admin 实用程序命令可用。换句话说，你已经准备好了！

当您想要更新 Django 源代码的副本时，请从 django 目录中运行命令 git pull。当您这样做时，Git 将下载任何更改。

如何安装 Django — Django 文档