如何安装 Django

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

安装 Python

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

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

Jython 上的 Django

Jython（Java 平台的 Python 实现）与 Python 3 不兼容，因此 Django ≥ 2.0 无法在 Jython 上运行。

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、MySQL、Oracle 和 SQLite。

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

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

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

如果您使用 PostgreSQL，则需要 psycopg2 包。有关更多详细信息，请参阅 PostgreSQL 注释。
如果您使用 MySQL，则需要一个 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，如果它已经过时，您可能需要更新它。如果它已过时，您就会知道，因为安装将不起作用。
看看 virtualenv 和 virtualenvwrapper。这些工具提供了隔离的 Python 环境，这比在系统范围内安装软件包更实用。它们还允许在没有管理员权限的情况下安装软件包。贡献教程介绍了如何创建 virtualenv。
创建并激活虚拟环境后，输入命令：

安装特定于发行版的包

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

安装开发版

跟踪 Django 开发

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

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

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

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

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

当您想要更新 Django 源代码的副本时，只需从 django 目录中运行命令 git pull。执行此操作时，Git 将自动下载任何更改。

如何安装 Django — Django 文档