$ python -m django --version

你可以在下列地址寻求帮助：

如果在学习本教程的过程中遇到问题，请向django-users发送邮件或者访问#django on irc.freenode.net与其他可能会帮助你的Django用户交流。

创建一个项目

如果这是你第一次使用Django，你需要完成一些初始化设置。 你需要自动生成一些代码，这些代码创建一个Django项目 — 一个Django实例的设置集合，包括数据库的配置、Django有关的选项和应用有关的选项。

从命令行cd到要存储代码的目录，然后运行以下命令：

$ django-admin startproject mysite

这将会在你的当前目录下生成一个 mysite 目录。 如果它不能工作，请查看运行django-admin遇到的问题。

让我们看一下startproject生成了什么：

mysite/manage.pymysite/__init__.pysettings.pyurls.pywsgi.py

这些文件是：

• 外层的mysite/根目录仅仅是项目的一个容器。 它的名字与Django无关；可以将其重命名为你喜欢的任何内容。
• manage.py：一个命令行工具，可以使你用多种方式对Django项目进行交互。 你可以在django-admin和manage.py中读到关于manage.py的所有细节。
• 内层的mysite/目录是你的项目的真正的Python包。 它是你导入任何东西时将需要使用的Python包的名字（例如 mysite.urls）。
• mysite/__init__.py：一个空文件，它告诉Python这个目录应该被看做一个Python包。 如果你是Python初学者，请在官方Python文档中阅读关于python包的更多内容。
• mysite/settings.py：该Django 项目的设置/配置。 Django settings 将告诉你这些设置如何工作。
• mysite/urls.py：此Django项目的URL声明；Django驱动的网站的“目录”。 你可以在URL dispatcher 中阅读到更多关于URL的内容。
• mysite/wsgi.py：用于你的项目的与WSGI兼容的Web服务器入口。 更多细节请参见如何使用WSGI部署。

开发服务器¶

让我们验证一下你的Django项目是否工作。 切换到 mysite 目录内，并运行以下命令：

$ python manage.py runserver

你将看到命令行下输出了以下内容：

Performing system checks...System check identified no issues (0 silenced).You have unapplied migrations; your app may not work properly until they are applied.（您有未应用的迁移；在应用之前，您的应用可能无法正常工作。）
Run 'python manage.py migrate' to apply them.    （运行'python manage.py migrate'来应用它们。）September 06, 2017 - 15:50:53
Django version 1.11, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

这表明你已经启动了Django开发服务器，一个用纯Python写的轻量级Web服务器。 我们在Django中内置了它，这样你就可以在不配置用于生产环境的服务器 —— 例如Apache —— 的情况下快速开发出产品，直到你准备好上线。

请注意：不要在任何生产环境使用这个服务器。 它仅仅是用于在开发中使用。 （我们的重点是编写Web框架，非Web服务器。）

既然服务器已经运行，请用你的浏览器访问 http://127.0.0.1:8000/。 在淡蓝色背景下，你将看到一个“Welcome to Django”的页面。 它运行成功了！

$ python manage.py runserver 8080

$ python manage.py runserver 0:8000

创建投票应用

现在，你的开发环境 —— 一个“项目” —— 已经建立起来，你将开始在上面做一些东西。

你编写的每个Django应用都是遵循特定约定且包含一个Python包。 Django自带一个工具，它可以自动生成应用的基本目录结构，这样你就能专心于书写代码而不是创建目录。

你的应用可以放在Python path上的任何位置。 在本教程中，我们将在你的manage.py文件同级目录创建我们的投票应用，以便可以将它作为顶层模块导入，而不是mysite的子模块。

要创建你的应用，请确保与manage.py在同一目录中，并键入以下命令：

$ python manage.py startapp polls

这将创建一个目录polls，它的结构如下：

polls/__init__.pyadmin.pyapps.pymigrations/__init__.pymodels.pytests.pyviews.py

我们的polls应用将基于这个目录结构。

编写你的第一个视图¶

我们来写第一个视图。 打开文件polls/views.py，并在其中放入以下Python代码：

from django.http import HttpResponsedef index(request):return HttpResponse("Hello, world. You're at the polls index.")

这是Django中最简单的视图。 要调用视图，我们需要将其映射到URL — 为此我们需要一个URLconf。

要在polls目录中创建一个URLconf，请创建一个名为urls.py的文件。 你的应用的目录应该如下所示：

polls/__init__.pyadmin.pyapps.pymigrations/__init__.pymodels.pytests.pyurls.pyviews.py

在polls/urls.py文件中包含以下代码：

from django.conf.urls import urlfrom . import viewsurlpatterns = [url(r'^$', views.index, name='index'),
]

下一步是将根URLconf指向polls.urls模块。 在mysite/urls.py中，添加一个django.conf.urls.include导入并且插入include()到 urlpatterns列表, 这样你就有了：

from django.conf.urls import include, url
from django.contrib import adminurlpatterns = [url(r'^polls/', include('polls.urls')),url(r'^admin/', admin.site.urls),
]

include()函数允许引用其他URLconfs。 请注意，include()函数的正则表达式不具有$（字符串结束匹配符），而是尾部斜线。 每当Django遇到include()时，它将删除与此相匹配的URL部分，并将剩余的字符串发送到包含的URLconf进行进一步处理。

include()背后的想法是即插即用使网址变得容易。 由于投票应用是在自己的URLconf（polls/urls.py）中，它们可以放在“/polls/”下或“/fun_polls/”下或“/content/polls/”下，或任何其他路径根，并且应用程序仍然可以工作。

你现在已将index视图连接到URLconf中。 让我们验证它的工作，运行以下命令：

$ python manage.py runserver

在浏览器中转到http://localhost:8000/polls/，你应该看到文本“Hello, world. You're at the polls index.”，这是你在index视图中定义的。

url()函数传递四个参数，两个必选参数：regex和view，两个可选参数：kwargs和name。 在这里，值得重新审视这些参数。