從哪里獲得幫助：

如果你在閱讀或?qū)嵺`本教程中遇到困難, 請(qǐng)發(fā)消息給 django-users 或加入 #django on irc.freenode.net 來和其他的 Django 用戶交流,，他們也許能幫到你。

創(chuàng)建項(xiàng)目?

如果這是你第一次使用 Django 的話,，你需要一些初始化設(shè)置,。也就是說，你需要用一些自動(dòng)生成的代碼配置一個(gè) Django project —— 即一個(gè) Django 項(xiàng)目實(shí)例需要的設(shè)置項(xiàng)集合,，包括數(shù)據(jù)庫配置,、Django 配置和應(yīng)用程序配置。

打開命令行,，cd 到一個(gè)你想放置你代碼的目錄,，然后運(yùn)行以下命令：

$ django-admin startproject mysite

...\> django-admin startproject mysite

這行代碼將會(huì)在當(dāng)前目錄下創(chuàng)建一個(gè) mysite 目錄。如果命令失敗了,，查看 運(yùn)行 django-admin 時(shí)遇到的問題,，可能能給你提供幫助。

讓我們看看 startproject 創(chuàng)建了些什么:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

這些目錄和文件的用處是：

• 最外層的 mysite/ 根目錄只是你項(xiàng)目的容器,， Django 不關(guān)心它的名字,，你可以將它重命名為任何你喜歡的名字。
• manage.py: 一個(gè)讓你用各種方式管理 Django 項(xiàng)目的命令行工具,。你可以閱讀 django-admin and manage.py 獲取所有 manage.py 的細(xì)節(jié)。
• 里面一層的 mysite/ 目錄包含你的項(xiàng)目,，它是一個(gè)純 Python 包,。它的名字就是當(dāng)你引用它內(nèi)部任何東西時(shí)需要用到的 Python 包名。 (比如 mysite.urls).
• mysite/__init__.py：一個(gè)空文件,，告訴 Python 這個(gè)目錄應(yīng)該被認(rèn)為是一個(gè) Python 包,。如果你是 Python 初學(xué)者，閱讀官方文檔中的 更多關(guān)于包的知識(shí),。
• mysite/settings.py：Django 項(xiàng)目的配置文件,。如果你想知道這個(gè)文件是如何工作的，請(qǐng)查看 Django settings 了解細(xì)節(jié),。
• mysite/urls.py：Django 項(xiàng)目的 URL 聲明,，就像你網(wǎng)站的“目錄”。閱讀 URL調(diào)度器 文檔來獲取更多關(guān)于 URL 的內(nèi)容,。
• mysite/wsgi.py：作為你的項(xiàng)目的運(yùn)行在 WSGI 兼容的Web服務(wù)器上的入口,。閱讀 如何使用 WSGI 進(jìn)行部署 了解更多細(xì)節(jié)。

用于開發(fā)的簡易服務(wù)器?

讓我們來確認(rèn)一下你的 Django 項(xiàng)目是否真的創(chuàng)建成功了,。如果你的當(dāng)前目錄不是外層的 mysite 目錄的話,，請(qǐng)切換到此目錄，然后運(yùn)行下面的命令：

$ python manage.py runserver

...\> py manage.py runserver

你應(yīng)該會(huì)看到如下輸出：

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.

六月 11, 2019 - 15:50:53
Django version 2.2, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

你剛剛啟動(dòng)的是 Django 自帶的用于開發(fā)的簡易服務(wù)器，它是一個(gè)用純 Python 寫的輕量級(jí)的 Web 服務(wù)器,。我們將這個(gè)服務(wù)器內(nèi)置在 Django 中是為了讓你能快速的開發(fā)出想要的東西,，因?yàn)槟悴恍枰M(jìn)行配置生產(chǎn)級(jí)別的服務(wù)器（比如 Apache）方面的工作，除非你已經(jīng)準(zhǔn)備好投入生產(chǎn)環(huán)境了,。

現(xiàn)在是個(gè)提醒你的好時(shí)機(jī)：千萬不要 將這個(gè)服務(wù)器用于和生產(chǎn)環(huán)境相關(guān)的任何地方,。這個(gè)服務(wù)器只是為了開發(fā)而設(shè)計(jì)的,。(我們在 Web 框架方面是專家，在 Web 服務(wù)器方面并不是,。)

現(xiàn)在,，服務(wù)器正在運(yùn)行，瀏覽器訪問 https://127.0.0.1:8000/,。你將會(huì)看到一個(gè)“祝賀”頁面,，隨著一只火箭發(fā)射，服務(wù)器已經(jīng)運(yùn)行了,。

$ python manage.py runserver 8080

...\> py manage.py runserver 8080

$ python manage.py runserver 0:8000

...\> py manage.py runserver 0:8000

創(chuàng)建投票應(yīng)用?

現(xiàn)在你的開發(fā)環(huán)境——這個(gè)“項(xiàng)目” ——已經(jīng)配置好了,，你可以開始干活了。

在 Django 中,，每一個(gè)應(yīng)用都是一個(gè) Python 包,，并且遵循著相同的約定。Django 自帶一個(gè)工具,，可以幫你生成應(yīng)用的基礎(chǔ)目錄結(jié)構(gòu),，這樣你就能專心寫代碼，而不是創(chuàng)建目錄了,。

你的應(yīng)用可以存放在任何 Python path 中定義的路徑,。在這個(gè)教程中，我們將在你的 manage.py 同級(jí)目錄下創(chuàng)建投票應(yīng)用,。這樣它就可以作為頂級(jí)模塊導(dǎo)入,，而不是 mysite 的子模塊。

請(qǐng)確定你現(xiàn)在處于 manage.py 所在的目錄下,，然后運(yùn)行這行命令來創(chuàng)建一個(gè)應(yīng)用：

$ python manage.py startapp polls

...\> py manage.py startapp polls

這將會(huì)創(chuàng)建一個(gè) polls 目錄,，它的目錄結(jié)構(gòu)大致如下：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

這個(gè)目錄結(jié)構(gòu)包括了投票應(yīng)用的全部內(nèi)容。

編寫第一個(gè)視圖?

讓我們開始編寫第一個(gè)視圖吧,。打開 polls/views.py,，把下面這些 Python 代碼輸入進(jìn)去：

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")

這是 Django 中最簡單的視圖。如果想看見效果,，我們需要將一個(gè) URL 映射到它——這就是我們需要 URLconf 的原因了,。

為了創(chuàng)建 URLconf，請(qǐng)?jiān)?polls 目錄里新建一個(gè) urls.py 文件,。你的應(yīng)用目錄現(xiàn)在看起來應(yīng)該是這樣：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    urls.py
    views.py

在 polls/urls.py 中，輸入如下代碼：

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

下一步是要在根 URLconf 文件中指定我們創(chuàng)建的 polls.urls 模塊,。在 mysite/urls.py 文件的 urlpatterns 列表里插入一個(gè) include(),， 如下：

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]

函數(shù) include() 允許引用其它 URLconfs。每當(dāng) Django 遇到 :func：~django.urls.include 時(shí),，它會(huì)截?cái)嗯c此項(xiàng)匹配的 URL 的部分,，并將剩余的字符串發(fā)送到 URLconf 以供進(jìn)一步處理,。

我們設(shè)計(jì) include() 的理念是使其可以即插即用。因?yàn)橥镀睉?yīng)用有它自己的 URLconf( polls/urls.py )，他們能夠被放在 "/polls/" ,， "/fun_polls/" ，"/content/polls/",，或者其他任何路徑下,，這個(gè)應(yīng)用都能夠正常工作。

你現(xiàn)在把 index 視圖添加進(jìn)了 URLconf。通過以下命令驗(yàn)證是否正常工作：

$ python manage.py runserver

...\> py manage.py runserver

用你的瀏覽器訪問 http://localhost:8000/polls/,，你應(yīng)該能夠看見 "Hello, world. You're at the polls index." ,，這是你在 index 視圖中定義的。

函數(shù) path() 具有四個(gè)參數(shù),，兩個(gè)必須參數(shù)：route 和 view，兩個(gè)可選參數(shù)：kwargs 和 name?，F(xiàn)在,，是時(shí)候來研究這些參數(shù)的含義了。