这份文档将会带领你使用Django框架
开始一个Python Web 框架, Django 需要依赖 Python环境.它基于Python 2.7, 3.2 或者3.3运行.
在https://www.python.org/download/或使用操作系统的软件包管理器获取最新版本的Python。
Django上的Jython
如果您使用Jython（Java平台的Python实现），则需要执行几个其他步骤。有关详细信息，请参见Running Django on Jython。
Python上的Python
如果你刚刚开始使用Django和使用Windows，你可能会发现How to install Django on Windows很有用。
如果您只想尝试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一起工作。
有关如何在安装mod_wsgi之后配置mod_wsgi的信息，请参阅How to use Django with mod_wsgi。
如果你出于某种原因不能使用mod_wsgi，不要害怕：Django支持许多其他部署选项。一个是uWSGI；它同样契合nginx。此外，Django遵循WSGI规范（ PEP 3333），这允许它在各种服务器平台上运行。
如果您计划使用Django的数据库API功能，您需要确保数据库服务器正在运行。Django支持许多不同的数据库服务器，并且正式支持PostgreSQL，MySQL，Oracle和SQLite。
如果您正在开发一个简单的项目或者您不打算在生产环境中部署，SQLite通常是最简单的选项，因为它不需要运行单独的服务器。但是，SQLite与其他数据库有很多不同之处，因此如果您正在处理大量的工作，建议您使用与生产中使用的数据库相同的数据库进行开发。
除了官方支持的数据库之外，还有由第三方提供的backends provided by 3rd parties允许您使用其他数据库与Django。
除了数据库后端，您还需要确保安装了Python数据库绑定。
如果您计划使用Django的manage.py migrate命令为模型自动创建数据库表（在首次安装Django并创建项目之后） ，您需要确保Django具有在您使用的数据库中创建和更改表的权限；如果您打算手动创建表格，只需授予Django SELECT，INSERT，UPDATE和DELETE权限即可。使用这些权限创建数据库用户后，您将在项目的设置文件中指定详细信息，有关详细信息，请参阅DATABASES。
如果您使用Django的testing framework测试数据库查询，Django将需要创建测试数据库的权限。
如果要从以前的版本升级Django的安装，则需要在安装新版本之前卸载旧的Django版本。
如果以前使用pip或easy_install安装了Django，则再次使用pip或easy_install安装会自动处理旧版本，所以你不需要自己做。
如果您以前使用python setup.py 安装安装了Django，卸载操作就像删除django目录从您的Python site-packages。要找到需要删除的目录，可以在shell提示符下运行以下命令（而不是交互式Python提示符）：
$ python -c "import sys; sys.path = sys.path[1:]; import django; print(django.__path__)"
安装说明稍有不同，具体取决于是安装特定于发行版的软件包，下载最新的正式版本还是获取最新的开发版本。
这很容易，无论你选择哪种方式。
这是安装Django的推荐方法。
安装pip。最简单的是使用独立pip安装程序。如果您的发布版本已安装pip，您可能需要更新它，如果它已过时。（如果它已过时，您会知道，因为安装不会工作。）
（可选）查看virtualenv和virtualenvwrapper。这些工具提供了孤立的Python环境，这比在系统范围内安装包更实用。它们还允许安装无管理员权限的软件包。这取决于你决定是否要学习和使用它们。
如果您使用Linux，Mac OS X或其他Unix风格，请输入命令sudo pip install Django。如果您使用的是Windows，请以管理员权限启动命令shell，然后运行命令pip install Django。这将在您的Python安装的site-packages目录中安装Django。
如果您使用的是virtualenv，则不需要sudo或管理员权限，这会将Django安装在virtualenv的site-packages目录中。
从我们的下载页面下载最新版本。
解开下载的文件（例如tar xzvf Django-XYtar.gz，其中X.Y的最新版本）。如果您使用的是Windows，则可以下载命令行工具bsdtar来执行此操作，也可以使用基于GUI的工具，例如7-zip。
切换到步骤2中创建的目录（例如cd Django-X.Y）。
If you’re using Linux, Mac OS X or some other flavor of Unix, enter the command sudo python setup.py install at the shell prompt. If you’re using Windows, start a command shell with administrator privileges and run the command python setup.py install.这将在您的Python安装的site-packages目录中安装Django。
删除旧版本
如果您使用此安装技术，请务必先remove any existing installations。否则，您可能会遇到一个破坏的安装，其中包括以前的版本，从Django中删除的文件。
检查distribution specific notes，看看您的平台/发行版是否提供了官方的Django包/安装程序。分发提供的包通常将允许自动安装依赖项和容易的升级路径；但是，这些包很少包含最新版本的Django。
跟踪Django开发
如果您决定使用Django的最新开发版本，则需要密切注意开发时间线，并且您需要密切关注release notes for the upcoming release。这将帮助您保持任何您可能想要使用的新功能，以及更新您的Django的副本，您需要对您的代码进行任何更改。（对于稳定版本，任何必要的更改都记录在版本说明中。）
如果您希望偶尔更新Django代码，并提供最新的错误修正和改进，请按照以下说明操作：
请确保您已安装Git，并且可以从shell运行其命令。（在shell提示符下输入git help以测试此操作。
检查Django的主要开发分支（'trunk'或'master'）如下：
$ git clone git://github.com/django/django.git django-trunk
这将在当前目录中创建一个目录django-trunk。
确保Python解释器可以加载Django的代码。最方便的方法是通过pip。运行以下命令：
$ sudo pip install -e django-trunk/
（如果使用virtualenv，您可以省略sudo。）
这将使Django的代码可以导入，并且还会使django-admin实用程序命令可用。换句话说，你已经准备好了！
警告
不要运行sudo python setup.py 安装 已经执行了步骤3中的等效操作。
When you want to update your copy of the Django source code, just run the command git pull from within the django-trunk directory. 当你这样做，Git会自动下载任何更改。
首先按照上面的步骤1和步骤2，以便您拥有一个django-trunk目录，并且检查Django的最新代码。然后将包含django-trunk目录的完整路径的.pth文件添加到系统的site-packages目录。例如，在类Unix系统上：
$ echo WORKING-DIR/django-trunk > SITE-PACKAGES-DIR/django.pth
在上述行中，更改WORKING-DIR/django-trunk以匹配到您的新django-trunk目录的完整路径，并更改SITE-PACKAGES-DIR以匹配系统的site-packages目录的位置。
site-packages目录的位置取决于操作系统和安装Python的位置。要查找系统的site-packages位置，请执行以下操作：
$ python -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())"
（请注意，这应该从shell提示符运行，而不是Python交互式提示符。）
一些基于Debian的Linux发行版为用户安装的软件包分离了site-packages目录，例如从下载的tarball安装Django。上面列出的命令将为您提供系统的site-packages，用户的目录可以在/usr/local/lib/中找到，而不是/usr/lib/。
接下来，您需要在您的shell PATH中使用django-admin.py实用程序。
在类Unix系统上，创建一个指向系统路径目录中django-trunk/django/bin/django-admin文件的符号链接，例如/usr/local/bin。例如：
$ ln -s WORKING-DIR/django-trunk/django/bin/django-admin.py /usr/local/bin/
（在上面的行中，更改WORKING-DIR以匹配到您的新django-trunk目录的完整路径。）
这只是让您从任何目录中键入django-admin.py，而不必使用文件的完整路径限定命令。
在Windows系统上，通过将文件django-trunk/django/bin/django-admin.py复制到系统路径上的某处可以实现相同的结果，例如C:\Python27\Scripts。
请注意，其余文档假定此实用程序安装为django-admin。如果您使用此方法，则必须替换为django-admin.py。
2015年5月13日