如何安装 Django

    Django 是一个 Python Web 框架。参见 获取更多细节。

    可以通过 https://www.python.org/downloads/ 或者操作系统的包管理工具获取最新版本的 Python。

    Windows 上的 Python

    如果您刚刚开始学习 Django 并且使用 Windows,查看 可能对你有帮助。

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

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

    若已安装 mod_wsgi 模块,请查看 Django 如何利用 mod_wsgi 工作 了解如何配置。

    如果由于某种原因你不能使用 mod_wsgi,请不要担心: Django 支持许多其他部署选项。一个是 ;它和 nginx 配合使用很好。此外,Django 遵循 WSGI 规范( ),允许它在各种服务器平台上运行。

    如果你打算使用 Django 的数据库 API 功能,你需要确保一个数据库服务器正在运行。Django 支持许多不同的数据库服务器,官方支持 PostgreSQL、、MySQL、 和 SQLite

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

    除了数据库后端,你还要确保安装了 Python 数据库绑定。

    • 如果你正在使用 PostgreSQL,你需要 包。相关详细信息请参阅 PostgreSQL 笔记
    • 如果你正在使用 MySQL 或 MariaDB,则需要一个像 mysqlclient 一样的 。 详细信息参见 MySQL 后端注意事项
    • 如果你正在使用 SQLite,则可能需要阅读 。
    • 如果你正在使用 Oracle,则需要 cx_Oracle 的副本,但请阅读 以获取有关 Oracle 和 cx_Oracle 支持的版本的详细信息。
    • 如果你使用的是非官方的第三方后端,请参阅提供的文档以了解任何其他要求。

    如果你打算使用 Django 的 manage.py migrate 命令为你的模型自动创建数据库表(首先安装 Django 并创建项目后),你需要确保 Django 有权限在你使用的数据库中创建和修改表;如果你打算手动创建表,你可以授予 Django SELECT、、UPDATEDELETE 权限。创建具有这些权限的数据库用户后,你将在项目的配置文件中指定详细信息,详细信息参见 DATABASES

    如果你正在使用 Django 的 来测试数据库查询,Django 将需要创建测试数据库的权限。

    安装过程可能会有些许差异,这取决于你是否在安装一个发行版——某个特定的版本,下载最新的正式发布包,或获取最新的开发版本。

    以下是安装 Django 的推荐方式。

    1. 安装 pip。最简单的方式是使用 。若你的系统早已安装 pip,你可能需要更新它,因为它可能过期了。如果它过期了,你会知道的,因为过期的用不了。

    2. 在你已创建并激活一个虚拟环境后,输入以下命令:

      Linux/MacOS    Windows

      1. ...\> py -m pip install Django

    查看 特定发行版注意事项 以查看你的平台/发行版是否提供了官方的 Django 软件包/安装程序。 发行版提供的软件包通常将允许自动安装依赖项和且易于升级; 但是,这些软件包很少包含最新版本的 Django。

    如果你决定使用 Django 的最新开发版,你需要关注 和 即将到来的新特性的发布说明。这将保证你能获取所有新特性和最新的代码。(对于稳定发布版,所有必要的修改都在发布说明中记录。)

    如果你希望偶尔能获取最新的补丁和改进,遵循以下说明:

    1. 确保你已安装了 ,这样你就可以从 shell 运行对应命令。(在 shell 中输入 测试是否安装。)

    2. 像这样检出 Django 的主开发分支:

      Linux/MacOS    Windows

      1. ...\> git clone https://github.com/django/django.git

      这会在当前目录创建一个 django 目录。

    3. 确保 Python 解释器可以加载 Django 的代码。最方便的方法是使用虚拟环境和 pip。 简略介绍了如何创建虚拟环境。